POST /presentations

curl "https://api.chroniclehq.com/api/v1/presentations" \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_123"
  }'

const response = await fetch("https://api.chroniclehq.com/api/v1/presentations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_id: "tpl_123",
  }),
});

const data = await response.json();
console.log(data);

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

curl "https://api.chroniclehq.com/api/v1/presentations" \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_123"
  }'

const response = await fetch("https://api.chroniclehq.com/api/v1/presentations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_id: "tpl_123",
  }),
});

const data = await response.json();
console.log(data);

Parameters

string

required

The template to create from

string[]

Optional subset of section IDs from the template to include. If omitted, all sections are included.

Response

A successful request returns 201 Created. The workspace is inferred from your API key.

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

string

Presentation ID

string

Presentation title

string

Workspace ID that owns the presentation

array

Presentation slides

boolean

Whether the presentation is public

string

Canonical presentation URL

string

ISO timestamp when the presentation was created

string

ISO timestamp when the presentation was last updated

FAQs

What does this endpoint do?

This endpoint creates a presentation from an existing template.Use it when you already know which template you want to use.

Can I create a presentation without a template?

No. This endpoint creates presentations from templates.If you want Chronicle to generate a presentation from a prompt, use the generate endpoint instead.

Should I hardcode template IDs?

No. Fetch templates first, then use the returned template ID.That keeps your integration aligned with the templates available to the workspace.

curl "https://api.chroniclehq.com/api/v1/presentations" \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_123"
  }'

const response = await fetch("https://api.chroniclehq.com/api/v1/presentations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_id: "tpl_123",
  }),
});

const data = await response.json();
console.log(data);

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

Get started

API reference

Reference

Parameters

Response

FAQs

Parameters

Response

FAQs

Related posts