Error Handling
In case a request to our API fails, the return value of the endpoints follows standard HTTP status code conventions.
A detailed reason can be found in the response. Common codes indicating a client error are 400 (Bad Request) & 404 (Not Found).
To give some further information on the cause of the error, the API also returns a standardized error object in the response body.
Description: A human-readable explanation for the cause of the error. For example:
Identity cannot be invited to this workspace. The identity is already part of the workspace.
The password is too simple
Link: A link to the corresponding documentation.
Details: Further explanations or hints on fixing the request.
ValidationErrors: If the model validation failed, all violations are listed here.
Error code | Description |
| The request is missing a valid team id. Most likely, your token is invalid. |
| The requested resource could not be located. |
| The request tried to perform an operation with an archived entity. |
| A property that requires a unique value detected a duplication. |
| The commit to the database failed. Your changes have not been committed! |
| Concurrent processes changed data and created conflicts in the process. |
| Two or more date values are in violation with each other (e.g. start date after due date). |
| A single date value is not in its validity range (e.g. birth date in the future). |
| A value is not in its defined range of validity (e.g. negative prices). |
| The request would have caused an illegal data state. |
| The body of the request is invalid or empty. |
| The model validation of the request failed. |
| An internal error occurred. |
| The request adds an entity which already exists. |
| The request contains an invalid filter or sort statement. |
| The request would cause a value transition which is not allowed. |
| The owner of the request has insufficient permissions. |
| The request for a batch operations is invalid. |
| The request tried to perform an operation with a deactivated user. |
| The uploaded file exceeds the allowed size limit |
| Your team does not have the required subscription level to use this feature. Upgrade to a higher plan. |
| Your team does not have enough remaining seats while trying to invite or activate users. |
HTTP Status Codes
On each request to our API, you will receive a response with a HTTP status code that indicates if it was successful.
Success Status Codes
Client Failure Status Codes
Last updated