Errors
If something goes wrong with an API request, the OneCal Unified API will return a 4xx or 5xx status code, and an error shape that looks like the following:
{
"error": "string",
"message": "string",
"requestId": "string"
}
The error field will be the name of the error. It is intended to be machine readable. The message field will be a human-readable message describing the error. The requestId field will be a unique identifier for the request. Provide this to support if you need to contact support.
Status codes
Here is a list of the different categories of status codes returned by the OneCal API. Use these to understand if a request was successful.
- Name
2xx- Description
A 2xx status code indicates a successful response.
- Name
4xx- Description
A 4xx status code indicates a client error — this means something is wrong with your request.
- Name
5xx- Description
A 5xx status code indicates a server error — this means something is wrong with the OneCal Unified API.