Back to Composio

Authentication

docs/content/reference/authentication.mdx

0.11.11.3 KB
Original Source

All Composio API endpoints require authentication via API key.

API Key Authentication

Include your API key in the x-api-key header.

Getting Your API Key

  1. Sign in to composio.dev
  2. Navigate to Settings
  3. In Project Settings, copy the key from the API Keys section
<Video src="/videos/fetch-project-key.mp4" autoPlay />

Organization API Key

For organization-level access across multiple projects, use the x-org-api-key header instead.

Getting Your Organization API Key

  1. Sign in to composio.dev
  2. Navigate to Organization SettingsGeneral Settings
  3. Copy the token under Organization Access Tokens
<Video src="/videos/fetch-org-key.mp4" autoPlay />

Using the API Key

Include your API key in the request header:

bash
curl https://backend.composio.dev/api/v3/tools \
  -H "x-api-key: $COMPOSIO_API_KEY"

For organization-level endpoints:

bash
curl https://backend.composio.dev/api/v3/org/projects \
  -H "x-org-api-key: $COMPOSIO_ORG_API_KEY"
<Cards> <Card title="Errors" href="/reference/errors"> Understanding API error responses </Card> <Card title="Rate Limits" href="/reference/rate-limits"> API rate limits by plan </Card> </Cards>