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_managedstring | boolean

Whether to filter by composio managed auth configs

toolkit_slugstring

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

deprecated_app_idstringDeprecated

The app id to filter by

deprecated_statusstringDeprecated

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

show_disablednullable boolean

Show disabled auth configs

Default: false
searchstring

Search auth configs by name

limitnullable number

Number of items per page, max allowed is 1000

cursorstring

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"
    ]
  }
}