Errors and limits

View as Markdown
This page describes the data-read APIs. Existing batch, outbound calling, and embedded URL APIs retain the error formats documented in their own guides.

Errors use the HTTP status and the application/problem+json media type. Preserve request_id when contacting support.

{
"type": "about:blank",
"title": "Bad Request",
"status": 400,
"detail": "conversation_time must use epoch seconds, not milliseconds.",
"code": "INVALID_ARGUMENT",
"request_id": "req_demo_001"
}
StatusMeaningClient action
400Invalid parameter, range, or cursorCorrect the request; restart the query for an invalid cursor.
401Missing or invalid credentialsCheck the assigned API key.
403Service or Voice Agent is outside your client accountUse a service or agent owned by your account.
404Resource unavailable within the authorized scopeCheck the ID and service.
429Rate limit exceededHonor Retry-After.
500 / 503Temporary server failureRetry reads with bounded exponential backoff and jitter.

The default page size is 20, with a maximum of 50 records and a date window of up to 31 days. The defaults are 300 requests per minute per IP, 30 per standard endpoint and export retrieval per API key, and 5 for export creation per API key; see rate limits. Cursors last 15 minutes. Export downloads remain available for seven days.