Meta tags:
description=Chronicle API error response shape and common HTTP status codes.;

Headings (most frequently used words):

error, codes, reference, documentation, index, format, common, status, retry, guidance, exponential, backoff, related, posts, on, this, page, get, started, api,

Text of the page (most frequently used words):
error (23), the (18), api (11), code (10), codes (8), not (8), chronicle (8), #status (7), page (7), key (7), common (6), developer (6), jwt (6), mcp (6), retry (5), and (5), request (5), required (5), one (5), message (5), missing (5), docs (5), get (5), presentations (5), this (4), documentation (4), attempt (4), wait (4), user (4), unknown (4), workspace (4), invalid (4), copy (4), reference (4), post (4), exponential (3), backoff (3), troubleshooting (3), authentication (3), rate (3), limits (3), retrying (3), these (3), help (3), unauthorized (3), 400 (3), bad (3), requests (3), causes (3), malformed (3), search (3), related (2), posts (2), guidance (2), format (2), scope (2), use (2), with (2), surface (2), will (2), 404 (2), found (2), 403 (2), forbidden (2), 402 (2), payment (2), 401 (2), cases (2), 504 (2), gateway (2), 503 (2), 502 (2), 500 (2), server (2), 429 (2), too (2), many (2), limit (2), generation (2), job (2), resource (2), expired (2), auth (2), header (2), path (2), workspace_id (2), fields (2), body (2), bad_request (2), http (2), readable (2), string (2), shape (2), support (2), home (2), generate (2), generationid (2), index (2), built, hosted, mintlify, platform, powered, website, linkedin, next, previous, pseudo, logic, jitter, when, without, changing, blindly, timeout, service, unavailable, internal, temporary, side, upstream, failure, occurred, unknown_internal_error, internal_error, exceeded, per, back, off, api_key_rate_limited, presentation, template, requested, does, exist, accessible, not_found, workspace_not_found, template_not_found, document_not_found, valid, but, outside, caller, reach, chr_, targeting, different, lacks, membership, feature, allowlist, only, usable, state, list_workspaces, mcp_not_enabled, workspace_access_denied, insufficient_privileges, clear, billing, upgrade, until, lifted, usage, hit, pricing_document_limit_reached, pricing_remix_over_limit, reconnect, via, oauth, flow, refresh, revoked, failed, apply, jwt_, jwt_signature_invalid, jwt_wrong_audience, jwt_expired, jwt_invalid, api_key_revoked, api_key_expired, api_key_invalid, authenticated, parameter, values, json, query, workspace_id_required, template_id, mirrored, for, convenience, number, human, machine, payload, object, description, type, field, errors, return, consistent, response, navigation, changelog, setup, uploads, create, target, patch, templates, introduction, quickstart, overview, started, skip, main, content, file, discover, all, available, pages, before, exploring, further, fetch, complete, llms, txt,

Text of the page (random words):
error codes chronicle developer docs documentation index fetch the complete documentation index at llms txt use this file to discover all available pages before exploring further skip to main content chronicle developer docs home page search k get started overview quickstart authentication api reference introduction get templates get presentations id post presentations patch presentations id post uploads create target post presentations generate get generationid status post presentations generate generationid message reference mcp setup api scope and rate limits error codes troubleshooting changelog get help support go to chronicle chronicle developer docs home page search k support go to chronicle go to chronicle search navigation reference error codes developer docs developer docs reference error codes copy page copy page chronicle api error response shape and common http status codes copy page copy page error format chronicle api errors return a consistent shape 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 bad_request message template_id is required status 400 common status codes 400 bad request the request is malformed or missing required fields error code is one of bad_request or workspace_id_required mcp jwt path with no workspace_id in body or query common causes missing required fields invalid json invalid parameter values missing workspace_id on jwt authenticated mcp requests 401 unauthorized authentication failed error code is one of api_key_invalid api_key_expired api_key_revoked unauthorized missing malformed header jwt_invalid jwt_expired jwt_wrong_audience or jwt_signature_invalid the jwt_ codes apply on the mcp jwt auth path common causes missing api key invalid api key expired api key revoked api key malformed auth header expired or invalid mcp jwt reconnect via the oauth flow to refresh 402 payment required 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 403 forbidden the api key or jwt is valid but the resource is outside the caller s reach error code is one of insufficient_privileges chr_ key targeting a different workspace workspace_access_denied jwt user lacks workspace membership or mcp_not_enabled user not in the mcp feature allowlist only list_workspaces is usable in this state 404 not found 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 429 too many requests the request exceeded the per api key rate limit error code is api_key_rate_limited back off and retry 500 502 503 504 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 related posts api scope and rate limits authentication troubleshooting previous troubleshooting next i x linkedin website powered by this documentation is built and hosted on mintlify a developer documentation platform on this page error format common status codes retry guidance exponential backoff related posts