Skip to main content
Every failed request returns an error object. Branch on code, which stays stable. message is written for people and can change.

Authentication errors

Type authentication_error, status 401.

Authorization errors

Type authorization_error, status 403.

Invalid requests

Type invalid_request, status 400.

Not found

Type not_found, status 404.

Conflicts

Type conflict, status 409.

Rate limits

Type rate_limit_error, status 429.

Server errors

Type api_error, status 500.

MCP endpoint

The MCP server can also reject a request before it reaches a tool. These errors have type invalid_request and no doc_url.