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.

CodeTitleSummary
200OKThe request was successful.
201CreatedThe request was successful and a new resource was created. Commonly used for successful POST requests.
204No ContentThe request was successful but there's no representation to return (i.e. the response is empty).
400Bad RequestThe request was invalid. This is often due to missing or malformatted parameters.
401UnauthorizedThe client failed to authenticate with the server. Typically, this is due to missing or invalid credentials.
403ForbiddenThe client authenticated but does not have access to the requested resource or operation.
404Not FoundThe requested resource could not be found.
405Method Not AllowedThe HTTP method used is not supported for this resource.
409ConflictThe request could not be completed due to a conflict with the current state of the target resource.
429Too Many RequestsThe user has sent too many requests in a given amount of time ("rate limiting").
500Internal Server ErrorA generic error occurred on the server.
502Bad GatewayThe server received an invalid response from an inbound server it accessed while attempting to process the request.
503Service UnavailableThe server is currently unable to handle the request due to maintenance or overload.
504Gateway TimeoutThe 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.