The Aurora API uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, authentication failed, etc.). Codes in the 5xx range indicate an error with Aurora's servers (these are rare).

Here is a more detailed summary of some of the codes:

  • 200 Success: The request was successfully processed.

  • 401 Unauthorized: The request was partially processed. The provided authentication token was successfully authenticated but not authorized to perform the intended action.

  • 404 Not Found: The request was partially processed. The provided authentication token was successfully authenticated and authorized, but the object/resource referenced does not exist or belongs under another tenant. This can also occur when IDs from other environments are used or when users have deleted certain resources such as a design or project.

  • 422 Unprocessable Entity: The request could not be processed. Usually, this indicates one or more mandatory parameters that are missing, such as keys or tokens required to identify and authenticate the API caller. Please check the signature, timestamp, URI and payload of the API call. This error also gets returned when we cannot authenticate the API caller.

  • 429 Too Many Requests: The request could not be processed. The client exceeded Aurora's API rate limit. To guard against bursts of incoming traffic and help maximize its stability, Aurora limits the number of requests received by the API within any given minute. Our default rate limit is 90 requests per minute. The rate limit is applied to all requests sent with the same API key. Please check the response body and/or the Retry-After response header for an indication when the next API call will be allowed. Note that most clients who run into the throttling limit run polling processes. We recommend the usage of webhooks. Please contact your Aurora account representative to discuss your specific needs. We are happy to help design a workflow that works for your business.

  • 5XX Internal Error: Some internal error occurred on our server. Please contact [email protected] or your dedicated support engineer.