Skip to content

API and developers

Manage API keys, authenticate requests, and resolve errors.

API keys

Create and revoke API keys

Create a scoped API key, copy its secret once, and revoke it when it is no longer needed.

Authenticate an API request

Send a Threetone API key in the x-api-key header and keep the credential out of client code.

Errors and requests

Resolve API access errors

Diagnose 401 and 403 responses from API key authentication and authorization checks.

Resolve request validation errors

Use a 422 response to find the invalid field and correct the request shape or value.

Handle rate limits and server errors

Back off after 429 responses and retry safe operations carefully after temporary server failures.