@devries-cameron20 / composio-1 / commits / dcc919382
Fork 0

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): add organization API key to authentication errors

- Document both x-api-key and x-org-api-key headers - Add invalid organization key error - Simplify error descriptions Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 28, 2026 at 13:45 UTC dcc919382b4cad03c745b6e56ad9e1533c497458
1 file changed +7 -4
docs/content/reference/errors.mdx
+7 -4
@@ -46,13 +46,16 @@ Composio uses conventional HTTP response codes to indicate the success or failur
46
47 ### Authentication errors
48
49 -Errors related to API key validation and permissions.
49 +Composio uses two types of API keys:
50 +- **Project API key** (`x-api-key`) — For project-level operations
51 +- **Organization API key** (`x-org-api-key`) — For organization-level access across projects
52
53 | Error | Cause |
54 |-------|-------|
53 -| Invalid API key | The API key provided is incorrect or has been revoked. Verify your key in [Settings](https://platform.composio.dev/settings). |
54 -| No authentication provided | The request is missing the `x-api-key` header. |
55 -| Invalid project access | The API key doesn't have access to this resource. Check that you're using the correct key scope. |
55 +| Invalid API key | The API key is incorrect or revoked. Verify in [Settings](https://app.composio.dev/settings). |
56 +| No authentication provided | The request is missing the `x-api-key` or `x-org-api-key` header. |
57 +| Invalid organization key | The organization API key is incorrect or revoked. Verify in Organization Settings. |
58 +| Insufficient permissions | The API key doesn't have access to this resource. |
59
60 <Callout>
61 See [Authentication Troubleshooting](/docs/troubleshooting/authentication) for more help.