Quickstart

# 1. Request a presigned target
TARGET=$(curl -s -X POST "https://api.chroniclehq.com/api/v1/uploads/create-target" \
  -H "Authorization: Bearer $CHRONICLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "research-notes.pdf",
    "content_type": "application/pdf",
    "declared_file_size": 524288
  }')

URL=$(echo "$TARGET" | jq -r '.url')
DOWNLOAD_URL=$(echo "$TARGET" | jq -r '.download_url')
FIELDS_ARGS=$(echo "$TARGET" | jq -r '.fields[] | "-F \(.name)=\(.value)"')

# 2. POST the file to S3 (no Authorization header, file last)
eval "curl -X POST \"$URL\" $FIELDS_ARGS -F file=@research-notes.pdf"

async function uploadAttachment(file) {
  const target = await chronicleFetch("/uploads/create-target", {
    method: "POST",
    body: JSON.stringify({
      file_name: file.name,
      content_type: file.type,
      declared_file_size: file.size,
    }),
  });

  const form = new FormData();
  for (const f of target.fields) form.append(f.name, f.value);
  form.append("file", file); // must be last

  const res = await fetch(target.url, { method: "POST", body: form });
  if (!res.ok) throw new Error(`S3 upload failed: ${res.status}`);

  return {
    id: crypto.randomUUID(),
    url: target.download_url,
    file_name: file.name,
    type: file.type,
  };
}

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.",
    "attachments": [
      {
        "id": "att_123",
        "url": "'"$DOWNLOAD_URL"'",
        "file_name": "research-notes.pdf",
        "type": "application/pdf"
      }
    ]
  }'

async function generatePresentation(templateId, prompt, attachments = []) {
  const data = await chronicleFetch("/presentations/generate", {
    method: "POST",
    body: JSON.stringify({
      template_id: templateId,
      prompt,
      ...(attachments.length > 0 ? { attachments } : {}),
    })
  });

  return data;
}

const generationJob = await generatePresentation(
  "tpl_123",
  "Create a 5-slide presentation summarizing our Q2 product launch, customer traction, and next-quarter priorities."
);

console.log(generationJob);

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

curl -X GET "https://api.chroniclehq.com/api/v1/presentations/generate/gen_123/status" \
  -H "Authorization: Bearer $CHRONICLE_API_KEY"

async function getGenerationStatus(generationId) {
  const data = await chronicleFetch(
    `/presentations/generate/${generationId}/status`,
    { method: "GET" }
  );

  return data;
}

const status = await getGenerationStatus("gen_123");
console.log(status);

{
  "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"
  }
}

curl "https://api.chroniclehq.com/api/v1/presentations/pres_789" \
  -H "Authorization: Bearer $CHRONICLE_API_KEY"

const res = await fetch(
  "https://api.chroniclehq.com/api/v1/presentations/pres_789",
  {
    headers: {
      Authorization: `Bearer ${CHRONICLE_API_KEY}`,
    },
  }
);

console.log(await res.json());

{
  "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"
}