Skip to main content
curl "https://api.chroniclehq.com/api/v1/presentations/generate" \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_123",
    "prompt": "Create a sales pitch deck for Chronicle aimed at agencies"
  }'

{
  "generation_id": "gen_123",
  "status": "generating",
  "poll_url": "/api/v1/presentations/generate/gen_123/status"
}

Documentation Index

Fetch the complete documentation index at: https://chronicle.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

curl "https://api.chroniclehq.com/api/v1/presentations/generate" \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_123",
    "prompt": "Create a sales pitch deck for Chronicle aimed at agencies"
  }'

​
Parameters

​
prompt
string
required
Instruction for what to generate
​
template_id
string
required
Template that seeds the generation
​
selected_section_ids
string[]
Optional subset of section IDs from the template to include. If omitted, all sections are included.

​
Response

A successful request returns 202 Accepted. The workspace is inferred from your API key. 
{
  "generation_id": "gen_123",
  "status": "generating",
  "poll_url": "/api/v1/presentations/generate/gen_123/status"
}
​
generation_id
string
Generation job ID
​
status
string
Current generation status
​
poll_url
string
Relative URL for checking generation status

​
FAQs

No. Generation is asynchronous. The endpoint starts a generation job and returns a generation_id. Use that ID to check status.
Use POST /api/v1/presentations to create from a template.Use POST /api/v1/presentations/generate to generate a presentation from a prompt.
Yes. Chronicle can pause generation and ask for more information.When that happens, the generation status returns awaiting_input.
Yes. Chronicle can reject a generation request before processing begins, including when usage limits are exceeded.Handle these responses separately from authentication errors.