Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fix(docs): improve HTTP status codes table formatting

Sushmithamalleshbdd955993e84
diff --git a/docs/content/reference/errors.mdx b/docs/content/reference/errors.mdx
index c6f14437f..71fbda908 100644
--- a/docs/content/reference/errors.mdx
+++ b/docs/content/reference/errors.mdx
@@ -30,18 +30,17 @@ Composio uses conventional HTTP response codes to indicate the success or failur
## HTTP status codes
-| Status | Description |
-|--------|-------------|
-| `200 - OK` | Everything worked as expected. |
-| `400 - Bad Request` | The request was unacceptable, often due to missing or invalid parameters. |
-| `401 - Unauthorized` | No valid API key provided. |
-| `403 - Forbidden` | The API key doesn't have permissions to perform the request. |
-| `404 - Not Found` | The requested resource doesn't exist. |
-| `409 - Conflict` | The request conflicts with another request. |
-| `410 - Gone` | The requested resource has been deleted. |
-| `422 - Unprocessable` | The request was valid but cannot be processed. |
-| `429 - Too Many Requests` | Too many requests hit the API too quickly. |
-| `500 - Server Error` | Something went wrong on Composio's end. |
+| Code | Status | Description |
+|------|--------|-------------|
+| 200 | OK | Everything worked as expected. |
+| 400 | Bad Request | The request was unacceptable, often due to missing a required parameter. |
+| 401 | Unauthorized | No valid API key provided. |
+| 403 | Forbidden | The API key doesn't have permissions to perform the request. |
+| 404 | Not Found | The requested resource doesn't exist. |
+| 409 | Conflict | The request conflicts with another request (perhaps due to using the same idempotent key). |
+| 422 | Unprocessable Entity | The request was valid but cannot be processed. |
+| 429 | Too Many Requests | Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |
+| 500, 502, 503, 504 | Server Errors | Something went wrong on Composio's end. (These are rare.) |
## Error types