Status Codes
The Gravity API uses standard HTTP status codes to indicate the result of an API request. Codes in the 2xx range indicate success, codes in the 4xx range indicate a client error, and codes in the 5xx range indicate a server error.
Code | Title | Summary |
---|---|---|
200 | OK | The request was successful. |
201 | Created | The request was successful and a new resource was created. Commonly used for successful POST requests. |
204 | No Content | The request was successful but there's no representation to return (i.e. the response is empty). |
400 | Bad Request | The request was invalid. This is often due to missing or malformatted parameters. |
401 | Unauthorized | The client failed to authenticate with the server. Typically, this is due to missing or invalid credentials. |
403 | Forbidden | The client authenticated but does not have access to the requested resource or operation. |
404 | Not Found | The requested resource could not be found. |
405 | Method Not Allowed | The HTTP method used is not supported for this resource. |
409 | Conflict | The request could not be completed due to a conflict with the current state of the target resource. |
429 | Too Many Requests | The user has sent too many requests in a given amount of time ("rate limiting"). |
500 | Internal Server Error | A generic error occurred on the server. |
502 | Bad Gateway | The server received an invalid response from an inbound server it accessed while attempting to process the request. |
503 | Service Unavailable | The server is currently unable to handle the request due to maintenance or overload. |
504 | Gateway Timeout | The server didn't receive a timely response from another server or some other auxiliary server it needed to access to complete the request. |
Please note that while the Gravity API strives to return the most appropriate HTTP status code, the specific code returned may vary depending on the operation.