Reference

Error codes

Errors should tell you what went wrong, what to do next, where to read more, and the request_id for support.

Envelope

JSON errors include an error code, message, docs URL placeholder, and request_id. The same request ID is returned in X-Request-Id.

Common codes

Runtime error codes are lowercase. `unauthorized` means add valid credentials, `forbidden` means use the correct key type or origin, `rate_limited` means back off using Retry-After, `validation_error` means fix request body shape, and `not_found` means the resource is missing or outside the authenticated scope.

Support

Include request_id, endpoint, key mode, and environment when asking for help. Never include full API keys.

Need rollout review?

Contact the team

Start in the dashboard, choose Script Tag or Server API, and use contact only when you need rollout review, enterprise coordination, or non-standard integration help. Billing beacon rules live in the API concepts guide.