---
title: "List authentication configurations with optional filters"
method: GET
path: "/api/v3.1/auth_configs"
tags: ["Auth Configs"]
---

# List authentication configurations with optional filters

`GET /api/v3.1/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.

## Query parameters

- `is_composio_managed` union — Whether to filter by composio managed auth configs
  - string
  - boolean
- `toolkit_slug` string
- `deprecated_app_id` string — DEPRECATED: This parameter will be removed in a future version. Please use toolkit_slug instead.
- `deprecated_status` string — DEPRECATED: This parameter will be removed in a future version.
- `show_disabled` boolean, nullable — Show disabled auth configs
- `search` string — Search auth configs by name or id
- `limit` number, nullable
- `cursor` string

## Response `200`

Successfully fetched auth configs

- object
  - `items` object[], required
    - `id` string, authConfigId, required — The unique ID of the authentication configuration
    - `uuid` string, required — The UUID of the authentication configuration (for backward compatibility)
    - `type` 'default' | 'custom', required — The type of the authentication configuration (custom or default)
    - `toolkit` object, required — Information about the associated integration
      - `slug` string, required — The unique identifier of the integration app
      - `logo` string, required — The URL to the integration app's logo image
      - `auth_guide_url` string, nullable — URL to a guide page with authentication setup instructions
      - `auth_hint_url` string, nullable — URL to a page where users can obtain or configure credentials
    - `name` string, required — The display name of the authentication configuration
    - `auth_scheme` 'OAUTH2' | 'OAUTH1' | 'API_KEY' | 'BASIC' | 'BILLCOM_AUTH' | 'BEARER_TOKEN' | 'GOOGLE_SERVICE_ACCOUNT' | 'NO_AUTH' | 'BASIC_WITH_JWT' | 'CALCOM_AUTH' | 'SERVICE_ACCOUNT' | 'SAML' | 'DCR_OAUTH' | 'S2S_OAUTH2' — The authentication scheme used (e.g., OAuth2, API Key, etc.)
    - `is_composio_managed` boolean — Whether this authentication configuration is managed by Composio or the user
    - `credentials` object — The authentication credentials (tokens, keys, etc.) - may be partially hidden for security
    - `proxy_config` object, nullable
      - `proxy_url` string, uri, required — The url of the auth proxy
      - `proxy_auth_key` string — The auth key for the auth proxy
    - `status` 'ENABLED' | 'DISABLED', required — Current status of the authentication configuration
    - `created_by` string — The identifier of the user who created the auth config
    - `created_at` string — ISO 8601 date-time when the auth config was created
    - `last_updated_at` string — ISO 8601 date-time when the auth config was last updated
    - `no_of_connections` number, required — The number of active connections using this auth config
    - `expected_input_fields` unknown[] — Fields expected during connection initialization
      - unknown
    - `restrict_to_following_tools` string[] — Use tool_access_config instead. This field will be deprecated in the future.
    - `tool_access_config` object, required
      - `tools_for_connected_account_creation` string[] — Tools used to generate the minimum required scopes for the auth config (only valid for OAuth). If passed, this will update the scopes.
      - `tools_available_for_execution` string[] — The actions that the user can perform on the auth config. If passed, this will update the actions that the user can perform on the auth config.
    - `shared_credentials` object — [EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config
    - `is_enabled_for_tool_router` boolean — Whether this auth config is enabled for tool router
  - `next_cursor` string, nullable
  - `total_pages` number, required
  - `current_page` number, required
  - `total_items` number, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)