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.