> ## Documentation index > > Fetch the complete documentation index at: https://andesine.app/docs/llms.txt > Use it to find all pages before you explore further. # Get a webhook delivery `GET https://api.andesine.app/webhooks/{id}/deliveries/{deliveryID}` Returns retained delivery metadata and, with content authority, the immutable event payload. Expired deliveries return not found even before physical cleanup. Required API key permissions: read:webhooks. Write permissions also grant read access for the same resource. ## Authentication Use one of: - `apiKey` (http, bearer, Andesine API key) - `oauth` (http, bearer, Andesine OAuth access token) ## Parameters ### Path - `id` (string, required) - `deliveryID` (string, required) ### Header - `x-workspace-id` (string, optional): Required for OAuth: ID of the workspace to access. API keys use their own workspace. ## Responses ### 200 OK Content type: `application/json` - `delivery` (`WebhookDelivery`, required) - `id` (string, required) - `endpointID` (string, required) - `eventID` (string, required) - `type` (`WebhookEventName`, required): One of: `"entry.created"`, `"entry.updated"`, `"entry.content_saved"`, `"entry.moved"`, `"entry.deleted"`, `"entry.restored"`, `"collection.created"`, `"collection.updated"`, `"collection.moved"`, `"collection.deleted"`, `"collection.restored"`, `"publishing.channel_advanced"`, `"publishing.channel_created"`, `"publishing.channel_deleted"`. - `occurredAt` (string, required) - `test` (boolean, required) - `state` (string, required): One of: `"pending"`, `"in_flight"`, `"succeeded"`, `"failed"`, `"cancelled"`. - `selectedRevision` (number, required) - `createdAt` (string, required) - `expiresAt` (string, required) - `retentionDays` (number, required) - `attemptCount` (number, required) - `currentRunID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `nextAttemptAt` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `lastHTTPStatus` (any of, required) - Any of: Option 1 (number) - Any of: Option 2 (null) - `lastFailureCategory` (any of, required) - Any of: Option 1 (string). One of: `"http_status"`, `"timeout"`, `"network"`, `"destination_policy"`, `"internal"`. - Any of: Option 2 (null) - `payload` (any of, required) - Any of: Option 1 (object) - `availability` (constant, required): Value: `"available"`. - `event` (`WebhookEvent`, required) - Any of: Option 1 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"entry"`. - `id` (string, required) - `type` (constant, required): Value: `"entry.created"`. - `data` (object, required) - `name` (string, required) - `collectionID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `contentHash` (string, optional) - Any of: Option 2 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"entry"`. - `id` (string, required) - `type` (constant, required): Value: `"entry.updated"`. - `data` (object, required) - `collectionID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `changedFields` (array of constant, required) - Any of: Option 3 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"entry"`. - `id` (string, required) - `type` (constant, required): Value: `"entry.content_saved"`. - `data` (object, required) - `collectionID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `contentHash` (string, required) - `savedAt` (string, required) - Any of: Option 4 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"entry"`. - `id` (string, required) - `type` (constant, required): Value: `"entry.moved"`. - `data` (any of, required) - Any of: Option 1 (object) - `scopeTransition` (constant, required): Value: `"within"`. - `reason` (string, required): One of: `"direct"`, `"ancestor_moved"`, `"reordered"`. - `from` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - `to` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - Any of: Option 2 (object) - `scopeTransition` (constant, required): Value: `"entered"`. - `reason` (string, required): One of: `"direct"`, `"ancestor_moved"`, `"reordered"`. - `from` (object, required) - `visibility` (constant, required): Value: `"hidden"`. - `to` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - Any of: Option 3 (object) - `scopeTransition` (constant, required): Value: `"left"`. - `reason` (string, required): One of: `"direct"`, `"ancestor_moved"`, `"reordered"`. - `from` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - `to` (object, required) - `visibility` (constant, required): Value: `"hidden"`. - Any of: Option 5 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"entry"`. - `id` (string, required) - `type` (constant, required): Value: `"entry.deleted"`. - `data` (object, required) - `name` (string, required) - `collectionID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `deletedAt` (string, required) - Any of: Option 6 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"entry"`. - `id` (string, required) - `type` (constant, required): Value: `"entry.restored"`. - `data` (object, required) - `name` (string, required) - `collectionID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - Any of: Option 7 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"collection"`. - `id` (string, required) - `type` (constant, required): Value: `"collection.created"`. - `data` (object, required) - `name` (string, required) - `parentID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - Any of: Option 8 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"collection"`. - `id` (string, required) - `type` (constant, required): Value: `"collection.updated"`. - `data` (object, required) - `parentID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `changedFields` (array of string, required): Unique items: `true`. - Any of: Option 9 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"collection"`. - `id` (string, required) - `type` (constant, required): Value: `"collection.moved"`. - `data` (any of, required) - Any of: Option 1 (object) - `scopeTransition` (constant, required): Value: `"within"`. - `reason` (string, required): One of: `"direct"`, `"ancestor_moved"`, `"reordered"`. - `from` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - `to` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - Any of: Option 2 (object) - `scopeTransition` (constant, required): Value: `"entered"`. - `reason` (string, required): One of: `"direct"`, `"ancestor_moved"`, `"reordered"`. - `from` (object, required) - `visibility` (constant, required): Value: `"hidden"`. - `to` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - Any of: Option 3 (object) - `scopeTransition` (constant, required): Value: `"left"`. - `reason` (string, required): One of: `"direct"`, `"ancestor_moved"`, `"reordered"`. - `from` (object, required) - `visibility` (constant, required): Value: `"visible"`. - `parentID` (any of, required): Null means the workspace root, never a hidden parent. - Any of: Option 1 (string) - Any of: Option 2 (null) - `order` (string, optional) - `to` (object, required) - `visibility` (constant, required): Value: `"hidden"`. - Any of: Option 10 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"collection"`. - `id` (string, required) - `type` (constant, required): Value: `"collection.deleted"`. - `data` (object, required) - `name` (string, required) - `parentID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `deletedAt` (string, required) - Any of: Option 11 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"collection"`. - `id` (string, required) - `type` (constant, required): Value: `"collection.restored"`. - `data` (object, required) - `name` (string, required) - `parentID` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - Any of: Option 12 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"channel"`. - `code` (string, required) - `type` (constant, required): Value: `"publishing.channel_advanced"`. - `data` (object, required) - `previousSnapshotID` (string, required) - `snapshotID` (string, required) - `reason` (string, required): One of: `"publish"`, `"unpublish"`. - Any of: Option 13 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"channel"`. - `code` (string, required) - `type` (constant, required): Value: `"publishing.channel_created"`. - `data` (object, required) - `name` (string, required) - `builtIn` (boolean, required) - `snapshotID` (string, required) - Any of: Option 14 (object) - `id` (string, required) - `operationID` (string, required) - `schemaVersion` (constant, required): Value: `1`. - `occurredAt` (string, required) - `workspaceID` (string, required) - `actor` (any of, optional): Default: `null`. - Any of: Option 1 (any of) - Any of: Option 1 (object) - `type` (constant, required): Value: `"member"`. - `memberID` (string, required) - Any of: Option 2 (object) - `type` (constant, required): Value: `"key"`. - `keyID` (string, required) - Any of: Option 3 (object) - `type` (constant, required): Value: `"extension"`. - `extensionID` (string, required) - Any of: Option 4 (object) - `type` (constant, required): Value: `"app"`. - `memberID` (string, required): The member who authorized the app. - `clientID` (string, required): OAuth client ID. - `name` (string, required): Name that the app registered, such as an MCP client. - Any of: Option 2 (null) - `test` (boolean, required) - `subject` (object, required) - `kind` (constant, required): Value: `"channel"`. - `code` (string, required) - `type` (constant, required): Value: `"publishing.channel_deleted"`. - `data` (object, required) - `name` (string, required) - `snapshotID` (string, required) - Any of: Option 2 (object) - `availability` (constant, required): Value: `"forbidden"`. - `currentRun` (any of, required) - Any of: `WebhookRun` - `id` (string, required) - `deliveryID` (string, required) - `number` (number, required) - `trigger` (string, required): One of: `"automatic"`, `"manual"`, `"test"`. - `destinationRevision` (number, required) - `state` (string, required): One of: `"pending"`, `"in_flight"`, `"succeeded"`, `"failed"`, `"cancelled"`. - `createdAt` (string, required) - `deadlineAt` (string, required) - `finishedAt` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `nextAttemptAt` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (null) - `attemptCount` (number, required) - `stopReason` (any of, required) - Any of: Option 1 (string). One of: `"retry_exhausted"`, `"expired"`, `"disabled"`, `"endpoint_deleted"`, `"destination_changed"`, `"selection_changed"`, `"access_revoked"`, `"destination_policy"`, `"test_completed"`. - Any of: Option 2 (null) - Any of: Option 2 (null) ### 400 400 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"BAD_REQUEST"`. - `status` (constant, required): Value: `400`. - `message` (string, required): Default: `"Bad Request"`. - `data` (`ValidationErrorData`, optional) - `hints` (array of string, optional): Suggested next steps. Wording can change; use error codes and structured data for program logic. - `issues` (array of `ValidationIssue`, optional) - `message` (string, required) - `code` (string, optional) - `path` (array of any of, optional) - Any of: Option 1 (string) - Any of: Option 2 (number) - Any of: Option 3 (object) - `key` (any of, required) - Any of: Option 1 (string) - Any of: Option 2 (number) - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional) ### 401 401 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"UNAUTHORIZED"`. - `status` (constant, required): Value: `401`. - `message` (string, required): Default: `"Unauthorized"`. - `data` (`ErrorData`, optional) - `hints` (array of string, optional): Suggested next steps. Wording can change; use error codes and structured data for program logic. - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional) ### 403 403 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"FORBIDDEN"`. - `status` (constant, required): Value: `403`. - `message` (string, required): Default: `"Forbidden"`. - `data` (`ForbiddenErrorData`, optional) - `hints` (array of string, optional): Suggested next steps. Wording can change; use error codes and structured data for program logic. - `missingPermissions` (array of string, optional) - `requiredPlan` (constant, optional): Value: `"pro"`. - `action` (string, optional): The requested action that was denied. - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional) ### 404 404 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"NOT_FOUND"`. - `status` (constant, required): Value: `404`. - `message` (string, required): Default: `"Not Found"`. - `data` (`ErrorData`, optional) - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional) ### 409 409 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"CONFLICT"`. - `status` (constant, required): Value: `409`. - `message` (string, required): Default: `"Conflict"`. - `data` (`ErrorData`, optional) - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional) ### 429 429 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"TOO_MANY_REQUESTS"`. - `status` (constant, required): Value: `429`. - `message` (string, required): Default: `"Too Many Requests"`. - `data` (`RateLimitErrorData`, optional) - `hints` (array of string, optional): Suggested next steps. Wording can change; use error codes and structured data for program logic. - `limit` (string, optional): The limit that was reached: a short-term rate limit, or a monthly API call, AI credit, or spending limit. One of: `"rate"`, `"api-calls"`, `"ai-credits"`, `"spending"`. - `retryAfterSeconds` (number, optional): Minimum delay before another attempt, in seconds. Also sent in Retry-After. - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional) ### 500 500 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"INTERNAL_SERVER_ERROR"`. - `status` (constant, required): Value: `500`. - `message` (string, required): Default: `"Internal Server Error"`. - `data` (`ErrorData`, optional) - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional) ### 503 503 Content type: `application/json` Type: one of. - One of: Option 1 (object) - `defined` (constant, required): Value: `true`. - `code` (constant, required): Value: `"SERVICE_UNAVAILABLE"`. - `status` (constant, required): Value: `503`. - `message` (string, required): Default: `"Service Unavailable"`. - `data` (`ErrorData`, optional) - One of: Option 2 (object) - `defined` (constant, required): Value: `false`. - `code` (string, required) - `status` (number, required) - `message` (string, required) - `data` (any, optional)