Projects

Projects are Composio's multi-tenancy primitive. Every Composio account belongs to an organization. Inside an organization, projects are isolated environments that scope your API keys, connected accounts, auth configs, and webhook configurations. Resources in one project are not accessible from another.

Common reasons to use multiple projects:

• Separate environments: keep production and staging isolated
• Separate products: keep resources for different apps independent
• Client isolation: give each client their own project with separate credentials and data

Managing projects

Manage projects from the dashboard or via the API using an organization API key (x-org-api-key).

There is no limit on the number of projects per organization. Project names must be unique within the organization. Create a project with should_create_api_key: true to get an API key back in the response:

curl -X POST https://backend.composio.dev/api/v3.1/org/owner/project/new \
  -H "x-org-api-key: YOUR_ORG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-staging-project",
    "should_create_api_key": true
  }'

{
  "id": "proj_abc123xyz456",
  "name": "my-staging-project",
  "api_key": "ak_abc123xyz456"
}

The list endpoint supports pagination with limit and cursor; getting a project by ID returns the full project object including its API keys.

Project settings

Each project has settings that control security, logging, and display behavior. These endpoints use your project API key (x-api-key), not the org key.

curl -X PATCH https://backend.composio.dev/api/v3.1/org/project/config \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mask_secret_keys_in_connected_account": false,
    "log_visibility_setting": "show_all"
  }'

Notable security setting: require_mcp_api_key, when true, requires MCP server requests to include a valid x-api-key header. This defaults to true for organizations created on or after March 5, 2026. You can also view and update project settings from Settings > Project Settings in the dashboard.

Endpoints