Skip to main content
Every error the Agent Sandboxes API returns has an HTTP status and a code. Errors use the Telnyx error envelope. title is the error’s name, and source points at the field or parameter at fault.
Output
A 503 carries a Retry-After header.

Sandbox Errors

Port Errors

A request to a port URL that the platform refuses carries the error in its body and the error’s title in a Telnyx-Sandbox-Error response header.
A port on a sandbox that is not running answers 502 with the sandbox_not_running body.

General Errors

Unknown fields are refused, never ignored. The control plane limits each API key to 20 requests per second. A refused request carries the ratelimit-limit, ratelimit-remaining, and ratelimit-reset headers and no Retry-After.

Control Plane Forwarding