HTTP errors

The Atla API follows a typical HTTP error format:

  • 400 - BadRequestError: The API could not understand the request due to invalid syntax.
  • 401 - AuthenticationError: Authentication is required and has not been provided or there is an issue with your API key.
  • 429 - RateLimitError: Your account has hit an internal rate limit and too many requests were made in a given amount of time.
  • 500 - InternalServerError: The API has encountered an unexpected condition that prevented it from fulfilling the request.

Error objects

Errors will always be returned as a JSON, with a error type key, the status_code for the given error and an additional message containing more information about the error. For example:

{
    "type": "error",
    "message": "There must be exactly one 'user' message.",
    "status_code": 400
}