# Errors and Response Codes

It is important that you handle different API response codes properly.  

| Status Code | Description                                                                                                                                                                                          |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200         | A status code of 200 indicates success. There should normally be a body returned with this status code that includes the data or result set.                                                         |
| 403         | HTTP 403 means you do not have the correct permissions to perform that operation. It is a fatal error and should not be retried.                                                                     |
| 429         | HTTP 429 means you have exceeded our rate limiting protection mechanisms. In this case, we recommend implementing a exponential backof mechanism and retrying the request in a short period of time. |
| 422         | HTTP 422 is a response returned on error by the fileio service. In this case, there is an upstream error from the cloud storage provider and the error details can be found in the response.         |
| 503         | HTTP 503 normally indicates a capacity issue on our end. Treat this the same as a 429 and implement an exponential back-of mechanism.                                                                |
| 500         | HTTP 500 indicates and unexpected error. Check the body for more details and implement a short retry/exponential backoff mechanism.                                                                  |

 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.couchdrop.io/errors-and-response-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.