What do the API error codes mean?

An error response has ok set to false and an error object with two fields. The code is a stable string your software can branch on, and the message explains the problem to a person.

HTTP 401 means the token is missing or no longer valid; check it under My Settings, API. HTTP 403 means the token is valid and the account lacks the right for this endpoint; managing tokens with a token is refused this way, with the code auth.session_required.

HTTP 404 means the record does not exist. HTTP 422 means a write failed validation, and the errors list names each field with a code and a message that says how to correct it. HTTP 429 carries a Retry-After header with the number of seconds to wait. The API reference lists the responses of each endpoint.

When you write to [email protected] about an error, include the request_id from the meta object and the time of the request. Leave the token out of the message.