API ReferenceAuth Configs

List authentication configurations with optional filters

Markdown
GET
/api/v3/auth_configs

Retrieves all auth configs for your project. Auth configs define how users authenticate with external services (OAuth, API keys, etc.). Use filters to find configs for specific toolkits or to distinguish between Composio-managed and custom configurations.

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication

In: header

Query Parameters

is_composio_managed?string|boolean

Whether to filter by composio managed auth configs

toolkit_slug?string

Comma-separated list of toolkit slugs to filter auth configs by

deprecated_app_id?stringDeprecated

The app id to filter by

deprecated_status?stringDeprecated

DEPRECATED: This parameter will be removed in a future version.

show_disabled?boolean|null

Show disabled auth configs

Defaultfalse
search?string

Search auth configs by name

limit?number|null

Number of items per page, max allowed is 1000

cursor?string

Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://backend.composio.dev/api/v3/auth_configs"
{
  "items": [
    {
      "id": "string",
      "uuid": "string",
      "type": "default",
      "toolkit": {
        "slug": "string",
        "logo": "string"
      },
      "name": "string",
      "auth_scheme": "OAUTH2",
      "is_composio_managed": true,
      "credentials": {
        "property1": null,
        "property2": null
      },
      "proxy_config": {
        "proxy_url": "http://example.com",
        "proxy_auth_key": "string"
      },
      "status": "ENABLED",
      "created_by": "string",
      "created_at": "string",
      "last_updated_at": "string",
      "no_of_connections": 0,
      "expected_input_fields": [
        {}
      ],
      "restrict_to_following_tools": [
        "string"
      ],
      "tool_access_config": {
        "tools_for_connected_account_creation": [],
        "tools_available_for_execution": []
      },
      "shared_credentials": {
        "property1": null,
        "property2": null
      },
      "is_enabled_for_tool_router": true,
      "deprecated_params": {
        "default_connector_id": "string",
        "member_uuid": "string",
        "toolkit_id": "string",
        "expected_input_fields": [
          {
            "property1": null,
            "property2": null
          }
        ]
      }
    }
  ],
  "next_cursor": "string",
  "total_pages": 0,
  "current_page": 0,
  "total_items": 0
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}