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.

​
Error format

Chronicle API errors return a consistent shape.
FieldTypeDescription
errorobjectError payload.
error.codestringMachine-readable error code.
error.messagestringHuman-readable error message.
error.statusnumberHTTP status, mirrored in the body for convenience.
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "template_id is required",
    "status": 400
  }
}

​
Common status codes

The request is malformed or missing required fields. error.code is BAD_REQUEST.Common causes:
  • Missing required fields
  • Invalid JSON
  • Invalid parameter values
Authentication failed. error.code is one of API_KEY_INVALID, API_KEY_EXPIRED, API_KEY_REVOKED, or UNAUTHORIZED (missing/malformed header).Common causes:
  • Missing API key
  • Invalid API key
  • Expired API key
  • Revoked API key
  • Malformed auth header
Workspace usage limits hit. error.code is one of PRICING_REMIX_OVER_LIMIT or PRICING_DOCUMENT_LIMIT_REACHED.Surface a clear billing/upgrade message to the user — retrying will not help until the limit is lifted.
The API key is valid, but the resource is outside the key’s workspace. error.code is INSUFFICIENT_PRIVILEGES.
The requested resource does not exist or is not accessible to the workspace. error.code is one of DOCUMENT_NOT_FOUND, TEMPLATE_NOT_FOUND, WORKSPACE_NOT_FOUND, or NOT_FOUND (unknown generation job).Common causes:
  • Unknown template ID
  • Unknown presentation ID
  • Unknown generation job ID
The request exceeded the per-API-key rate limit. error.code is API_KEY_RATE_LIMITED. Back off and retry.
A temporary server-side or upstream failure occurred. error.code is INTERNAL_ERROR or UNKNOWN_INTERNAL_ERROR.

​
Retry guidance

Retry these cases:
  • 429 Too Many Requests
  • 500 Internal Server Error
  • 502 Bad Gateway
  • 503 Service Unavailable
  • 504 Gateway Timeout
Do not blindly retry these cases:
  • 400 Bad Request
  • 401 Unauthorized
  • 402 Payment Required
  • 403 Forbidden
  • 404 Not Found
Surface these to the user — retrying without changing the request will not help.

​
Exponential backoff

Use exponential backoff with jitter when retrying. Pseudo-logic: 
attempt 1: wait 1s
attempt 2: wait 2s
attempt 3: wait 4s
attempt 4: wait 8s