API Responses

XCover uses conventional HTTP response codes to indicate the success or failure of API requests. Error codes ranging from 200 to 299 indicate successful operations. Error codes ranging from 400 to 499 represent various error codes. Errors that can be resolved programmatically will result in an error code that briefly explains the error type and the reason for failure. 5xx codes indicate an unexpected error within the XCover application. In the unlikely event of a 5xx error, our engineering team will automatically receive a notification and will fix the issue as fast as possible.
200 - OK
Everything worked as expected
201 - Created
The request has been fulfilled and has resulted in one or more new resources being created
400 - Bad Request
The request was not accepted, often due to the wrong format of the request
401 - Unauthorized
No valid API key was provided
404 - Not Found
The requested resource doesn't exist
409 - Conflict
The request conflicts with another request, perhaps due to the usage of the same idempotency key
422 - Unprocessable Entity
Validation failed or logical error
429 - Too Many Requests
Too many requests hit the API too quickly. We recommend an exponential back-off of your requests.
500, 502, 503, 504 - Server Errors
Something went wrong on XCover side