Skip to main content

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.

Before you begin, you’ll need:
  • Chronicle workspace with API enabled (available on Max and Business plans)
  • Node.js 18+ or another runtime with fetch support
1

Create an API key

  • Open Chronicle
  • Navigate to Settings → API
  • Create an API key
  • Copy and store it securely, you won’t be able to see it again
export CHRONICLE_API_KEY="your_api_key_here"
Include the key in the header with every request. Supported headers:
  • Authorization: Bearer <API_KEY>
  • x-api-key: <API_KEY>
2

Start a generation from a prompt

curl -X POST "https://api.chroniclehq.com/api/v1/presentations/generate" \
  -H "Authorization: Bearer $CHRONICLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_123",
    "prompt": "Create a 5-slide presentation summarizing our Q2 product launch, customer traction, and next-quarter priorities."
  }'
The request returns 202 Accepted with a generation_id you can poll.
{
  "generation_id": "gen_123",
  "status": "generating",
  "poll_url": "/api/v1/presentations/generate/gen_123/status"
}
3

Poll for completion

Poll the status endpoint until status is completed, failed, or awaiting_input.
curl -X GET "https://api.chroniclehq.com/api/v1/presentations/generate/gen_123/status" \
  -H "Authorization: Bearer $CHRONICLE_API_KEY"

{
  "generation_id": "gen_123",
  "status": "completed",
  "presentation": {
    "id": "pres_789",
    "title": "Q2 Product Launch Review",
    "workspace_id": "ws_123",
    "sections": [],
    "is_public": false,
    "url": "https://app.chroniclehq.com/ws_123/document/pres_789",
    "created_at": "2026-04-30T00:00:00.000Z",
    "updated_at": "2026-04-30T00:00:00.000Z"
  }
}
4

View and use your Chronicle deck

Open the url from the completed payload, or fetch the presentation later by ID:
curl "https://api.chroniclehq.com/api/v1/presentations/pres_789" \
  -H "Authorization: Bearer $CHRONICLE_API_KEY"

{
  "id": "pres_789",
  "title": "Q2 Product Launch Review",
  "workspace_id": "ws_123",
  "sections": [],
  "is_public": false,
  "url": "https://app.chroniclehq.com/ws_123/document/pres_789",
  "created_at": "2026-04-30T00:00:00.000Z",
  "updated_at": "2026-04-30T00:00:00.000Z"
}