Error Handling
Catenda uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted), and codes in the 5xx range indicate a system error that cannot be resolved by the user.
Error responses are JSON objects comprised of a code and a message. The code is the numerical error code of the error and the message contains a human-readable message describing the error.
Code | Description |
---|---|
23 | The uploaded file is empty |
24 | Incorrect field or content in the request |
102 | Viewer token provided is invalid |
Code | Description |
---|---|
10 | The access token is missing |
11 | The access token provided is empty or invalid |
12 | The access token provided has expired |
Code | Description |
---|---|
21 | Forbidden action |
100 | Insufficient privilege for action |
101 | Maximum number of projects for organization reached |
Code | Description |
---|---|
20 | Couldn't find the specified resource |
Code | Description |
---|---|
25 | Action is incompatible with the specified resource |
600 | Action is incompatible with the specified custom field |
Code | Description |
---|---|
22 | Input provided is incompatible |
Code | Description |
---|---|
30 | Error occurred on the server |
103 | Multi-factor authorization required |