---
title: Error Handling
slug: errors
docTags: 
createdAt: 2024-06-11T11:07:52.486Z
---

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.

## 400 Bad Request

| Code | Description                               |
| ---- | ----------------------------------------- |
| 23   | The uploaded file is empty                |
| 24   | Incorrect field or content in the request |
| 102  | Viewer token provided is invalid          |

## 401 Unauthorized

| Code | Description                                   |
| ---- | --------------------------------------------- |
| 10   | The access token is missing                   |
| 11   | The access token provided is empty or invalid |
| 12   | The access token provided has expired         |

## 403 Forbidden

| Code | Description                                         |
| ---- | --------------------------------------------------- |
| 21   | Forbidden action                                    |
| 100  | Insufficient privilege for action                   |
| 101  | Maximum number of projects for organization reached |

## 404 Not Found

| Code | Description                          |
| ---- | ------------------------------------ |
| 20   | Couldn't find the specified resource |

## 409 Conflict

| Code | Description                                            |
| ---- | ------------------------------------------------------ |
| 25   | Action is incompatible with the specified resource     |
| 600  | Action is incompatible with the specified custom field |

## 422 Unprocessable Content

| Code | Description                    |
| ---- | ------------------------------ |
| 22   | Input provided is incompatible |

## 500 Internal Server Error

| Code | Description                         |
| ---- | ----------------------------------- |
| 30   | Error occurred on the server        |
| 103  | Multi-factor authorization required |