Response Codes and Messages
This document includes an overview of the response status codes you might experience when using our APIs and what they mean in our ecosystem.
2xx Status Codes [Success]
- 200 – OK
- 204 – Success: is used in the authentication endpoints, depending on the URL endpoint the status means a successful operation. Here is a description of the 204 for each endpoint:
/v1/create-user
User Created./v1/confirm-user
User Confirmed./v1/forgot-password
Confirmation code sent successfully./v1/forgot-password-confirm
Password reset successfully./v1/change-password
Successful password change./v1/token-revoke
Token was successfully revoked./v1/forgot-password
Confirmation code sent successfully.
3xx Status Codes [Redirection]
- 307 – Temporary Redirect: Used to redirect the request to an object storage URL for large files: snapshots and chunks. It’s the success status code for those endpoints (snapshots/download, chunks/download).
4xx Status Codes [Client Error]
- 401 – Unauthorized: The server couldn’t verify your credentials. This usually means your user credentials are invalid or missing, or access_token is invalid or expired. Make sure you’re sending the correct credentials with your request.
- 403 – Forbidden: You’ve been authenticated, but your permissions aren’t sufficient to complete this operation.
- 404 – Not Found: The server can’t locate the resource you’re requesting. This could be due to a typo in the endpoint path.
- 422 – Unprocessable Entity: The server understood your request, but there’s a semantic issue with the data you’ve provided. This often happens if required fields are missing, or the data format doesn’t match what the API expects. Review the request payload for any inconsistencies.
5xx Status Codes [Server Error]
- 500 – Internal Server Error: The server encountered an unexpected condition that prevented it from fulfilling the request. Retry request.