API reference

Authentication

Before making API calls, you’ll need to create an API key.

Method	Endpoint	Description
GET	/templates	List available templates
GET	/presentations/:id	Fetch an existing presentation
POST	/presentations	Create a new presentation from a template.
PATCH	/presentations/:id	Update presentation metadata (title only in v1).
POST	/uploads/create-target	Get a presigned S3 target for uploading an attachment.
POST	/presentations/generate	Start an AI presentation generation job.
GET	/presentations/generate/:generationId/status	Poll the current status of a generation job.
POST	/presentations/generate/:generationId/message	Send a follow-up message.

All API requests are made to:

https://api.chroniclehq.com/api/v1

Field	Type	Description
`error`	object	Error payload.
`error.code`	string	Machine-readable error code.
`error.message`	string	Human-readable error message.
`error.status`	number	HTTP status, mirrored in the body for convenience.

{
  "error": {
    "code": "INSUFFICIENT_PRIVILEGES",
    "message": "Presentation does not belong to this workspace",
    "status": 403
  }
}

For HTTP status semantics and common failure modes, see Error codes.