API
Ask or search…
K
Links

HTTP Status Codes

2xx

HTTP
Status Code
Meaning
Possible Reason(s)
200
  • OK
  • Any method finished successfully
201
  • Created
  • POST method on an entity inserted new data successfully

3xx

HTTP
Status Code
Meaning
Possible Reason(s)
304
  • Not Modified
  • ETag: GET method with "If-None-Match" header if an entity has not been changed

4xx

HTTP
Status Code
Meaning
Possible Reason(s)
400
  • Bad request
  • Invalid body, query parameter or path parameter
  • An entity in the request body failed a validation
401 [1]
  • Authentication error
  • Missing or invalid "Authorization" header
403 [1]
  • Authorization error
  • Invalid or expired access token (JWT)
  • Insufficient permissions
404
  • Invalid or non-existent resource ID
  • GET method did not find any entity matching the filter
405
  • Method Not Allowed
409
  • Conflict
  • PUT or PATCH method on an entity if the "versionDate" verification fails
412
  • Precondition Failed
  • ETag: PUT or PATCH method with "If-Match" header if an entity has been changed
428
  • Precondition Required
  • ETag: PUT or PATCH method on an entity called without the "If-Match" header
429
  • Too Many Requests
[1] The error response for status codes 401 and 403 has an extra field reason so as to further differentiate the situations programmatically. The value is an enumeration and can be one of these:
"reason"
"status"
Meaning / more detailed reason
INVALID_AUTH_HEADER
401
The Authorization header is missing or has an invalid value.
INVALID_REFRESH_TOKEN
401
The refresh token is invalid (not found).
BAD_REGISTRATION
401
Internal error - call the support.
UNAUTHORIZED
401
Not authorized with no specific reason given.
AUTHENTICATION_FAILED
401
Generic authentication error - call the support.
INVALID_ACCESS_TOKEN
403
The access token cannot be parsed or the signature verification failed.
ACCESS_TOKEN_EXPIRED
403
The access token has expired. Sign in again.
CLOUD_FORBIDDEN
403
The access to the given cloud is not allowed.
DOMAIN_FORBIDDEN
403
The access to the endpoint path is not allowed.
ACCESS_DENIED
403
The access is denied with no specific reason given.
AUTHORIZATION_FAILED
403
Generic authorization error - call the support.

5xx

HTTP
Status Code
Meaning
Possible Reason(s)
500
  • Internal Server Error
  • Any method unexpectedly failed
501
  • Not Implemented
  • Feature has not been implemented yet.