> ## 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_changelog

> Kick off a public changelog generation from recent commits

Analyses commits on the project's tracked GitHub repositories and kicks off a background task that generates a public changelog. Returns immediately with a pending content record.

## Arguments

| Name           | Type              | Default      | Description                                             |
| -------------- | ----------------- | ------------ | ------------------------------------------------------- |
| `start_date`   | string (ISO-8601) | 7 days ago   | Earliest commit timestamp to include.                   |
| `end_date`     | string (ISO-8601) | now          | Latest commit timestamp to include.                     |
| `product_name` | string            | project name | Override the product name used in the generated header. |

## Returns

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

Poll for completion by calling `list_changelogs` / `get_changelog` (or the REST API equivalents) — the content appears there once the background task transitions the record's status to `completed`.

## Errors

* `No GitHub account connected` — connect GitHub in Sources first.
* `No active tracked repositories` — add at least one active repo in Sources.

## Example prompts

> "Generate a changelog covering everything we shipped in the last two weeks."

> "Kick off a changelog for the 2026-03-01 → 2026-03-15 window."