Skip to main content

Status codes and error responses you can encounter when using the API.

The Delivery API returns error detail in a generic format so that it can be easily handled in a consistent way. Detailed error information is not exposed in the response to ensure security sensitive details are not leaked.

Typical HTTP status codes

Below are the current status codes returned from the Delivery API.

Status code Error code Description
400 BadRequest The request could not be understood or was missing required parameters
403 AccessDenied The action is not authorised for the current user
404 NotFound The resource was not found
500 ServerError An error occurred on the server. Something went wrong processing the request

Error response

Each response follows the same rules.

Name Type Format Description
logId string GUID The logId as a 128 bit GUID.
This can be used within the Contensis log search to understand further details about the error
message string   A description of the error
data any   An object containing specific data relevant to the error
type string   The type of error - for the Delivery API, this will always be error

Example error response

500 - ServerError

JSON
{
  "logId": "63cb1df0-b82a-459e-accc-635e187f3b8b",
  "message": "An error occurred requesting the entry",
  "data": {
      "entryId": "ba8a92bd-0e5f-465e-acec-3cdb3db38df6",
      "projectId": "moveiDb"
  },
  "type": "error"
}

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.
New support request