> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipstar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# generate_blog_post

> Kick off a blog post generation from recent commits

Kicks off background generation of a blog post drawing from commits on the project's tracked repositories.

## Arguments

| Name           | Type              | Default      | Description                                 |
| -------------- | ----------------- | ------------ | ------------------------------------------- |
| `start_date`   | string (ISO-8601) | 7 days ago   | Earliest commit timestamp to consider.      |
| `end_date`     | string (ISO-8601) | now          | Latest commit timestamp to consider.        |
| `product_name` | string            | project name | Override the product name.                  |
| `idea`         | object            | *none*       | Optional idea to steer the post. See below. |

### `idea` object

Pair with [`generate_blog_post_ideas`](/mcp/generation/generate-blog-post-ideas) to pick an angle first, then pass one of the returned ideas back here.

```json theme={null}
{
  "title": "Ship faster with webhook retries",
  "summary": "We shipped per-endpoint retry budgets this week...",
  "angle": "Reliability story for platform teams",
  "category": "Engineering"
}
```

## Returns

```json theme={null}
{
  "content_id": "7f5e2c1a-...",
  "status": "pending"
}
```

Poll `list_blog_posts` / `get_blog_post` once the background task completes.

## Example prompts

> "Brainstorm three blog post ideas from this week's commits, pick the one about the new webhook retries, and kick off generation."

> "Draft a blog post covering everything we shipped in March."