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 thread. |
idea | object | — | Optional {title, summary} suggestion to focus the thread on; commits unrelated to the idea are ignored. |
audience | "technical" | "business" | "mixed" | project default | Technical depth of the writing. Omit to use the project’s content guidelines default. |
instructions | string (≤ 2000 chars) | project default | Free-text guidance on scope, tone, or terminology, e.g. "British spelling; do announce docs-site changes". Omit to use the project default. |
repos | string[] | all tracked repos | Restrict the commit source to these tracked repositories (full names, e.g. ["acme/backend"]), as listed by get_project_context. Omit to use every active tracked repo. |
changelog_id | string (UUID) | — | Draft the thread from this changelog instead of the commit log: the content_id of a completed changelog in the same project (as returned by generate_changelog). The thread then announces one of that changelog’s entries and nothing the changelog does not say, and takes the changelog’s period — start_date, end_date and repos are ignored. |