Skip to main content
Composio 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 with the information provided, and codes in the 5xx range indicate an error with Composio’s servers.

The error object

Attributes

HTTP status codes

Error types

Authentication errors

Composio uses two types of API keys:
  • Project API key (x-api-key) — For project-level operations
  • Organization API key (x-org-api-key) — For organization-level access across projects
See Authenticating users for more help.

Tool errors

Errors that occur when fetching or executing tools.
See Tools and toolkits for more help.

Connection errors

Errors related to connected accounts.

Trigger errors

Errors related to trigger subscriptions.
See Triggers for more help.

Rate limiting

When you hit rate limits, you’ll receive a 429 status code. See Rate Limits for details on limits by plan and best practices for handling rate limit errors.

Getting help

When contacting support, include the request_id from the error response.

Discord

Community support

Email

Contact support team

GitHub

Report a bug