Skip to content

Error Handling โ€‹

Use this page to understand:

  • How API errors are structured
  • How to use code, message, and doc_url

Error Response Body โ€‹

FieldTypeDescription
errorsarrayList of one or more error objects.
errors[].codestringStable machine-readable code for client handling.
errors[].messagestringHuman-readable detail of what failed.
errors[].doc_urlstringAbsolute URL to the matching error-code page (domain depends on deployed docs environment).

Recommendation

Use code TODO ...

Error Code Directory โ€‹

5 results

Error codeHTTP statusDescription
parameter_invalid400One or more request parameters do not satisfy the expected schema.
resource_not_found404The requested resource does not exist.
conflict409The request could not be completed because of a state conflict.
unauthorized401Authentication is missing, invalid, or rejected.
internal_server_error500An unexpected server-side error occurred.

HTTP Status Code Reference โ€‹

HTTP statusMeaning in current API behavior
200 OKSuccessful cancellation response
201 CreatedResource created successfully
401 UnauthorizedMissing or invalid authentication
400 Bad RequestRequest validation or client input error
404 Not FoundReferenced entity or request does not exist
409 ConflictOperation rejected due to state conflict
500 Internal Server ErrorUnexpected server error