> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List authentication configurations with optional filters

> 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.



## OpenAPI

````yaml api-reference/openapi-v3.json GET /api/v3/auth_configs
openapi: 3.0.0
info:
  version: 3.0.0
  title: Composio Platform API
  description: >-
    Composio v3 API — legacy endpoints under /api/v3/. Use v3.1 for new
    integrations.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
paths:
  /api/v3/auth_configs:
    get:
      tags:
        - Auth Configs
      summary: List authentication configurations with optional filters
      description: >-
        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.
      operationId: getAuthConfigs
      parameters:
        - schema:
            anyOf:
              - type: string
              - type: boolean
            description: Whether to filter by composio managed auth configs
          required: false
          description: Whether to filter by composio managed auth configs
          name: is_composio_managed
          in: query
        - schema:
            type: string
          required: false
          description: Comma-separated list of toolkit slugs to filter auth configs by
          in: query
          name: toolkit_slug
        - schema:
            type: string
            description: >-
              DEPRECATED: This parameter will be removed in a future version.
              Please use toolkit_slug instead.
            deprecated: true
          required: false
          description: The app id to filter by
          name: deprecated_app_id
          in: query
        - schema:
            type: string
            description: 'DEPRECATED: This parameter will be removed in a future version.'
            deprecated: true
          required: false
          name: deprecated_status
          in: query
        - schema:
            type: boolean
            nullable: true
            default: false
            description: Show disabled auth configs
          required: false
          description: Show disabled auth configs
          name: show_disabled
          in: query
        - schema:
            type: string
            description: Search auth configs by name or id
          required: false
          description: Search auth configs by name or id
          name: search
          in: query
        - schema:
            type: number
            nullable: true
          required: false
          description: Number of items per page, max allowed is 200
          name: limit
          in: query
        - schema:
            type: string
          required: false
          description: >-
            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.
          name: cursor
          in: query
      responses:
        '200':
          description: Successfully fetched auth configs
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: authConfigId
                          description: The unique ID of the authentication configuration
                        uuid:
                          type: string
                          description: >-
                            The UUID of the authentication configuration (for
                            backward compatibility)
                          deprecated: true
                        type:
                          type: string
                          enum:
                            - default
                            - custom
                          description: >-
                            The type of the authentication configuration (custom
                            or default)
                        toolkit:
                          type: object
                          properties:
                            slug:
                              type: string
                              description: The unique identifier of the integration app
                            logo:
                              type: string
                              description: The URL to the integration app's logo image
                            auth_guide_url:
                              type: string
                              nullable: true
                              description: >-
                                URL to a guide page with authentication setup
                                instructions
                            auth_hint_url:
                              type: string
                              nullable: true
                              description: >-
                                URL to a page where users can obtain or
                                configure credentials
                          required:
                            - slug
                            - logo
                          description: Information about the associated integration
                        name:
                          type: string
                          description: The display name of the authentication configuration
                        auth_scheme:
                          type: string
                          enum:
                            - OAUTH2
                            - OAUTH1
                            - API_KEY
                            - BASIC
                            - BILLCOM_AUTH
                            - BEARER_TOKEN
                            - GOOGLE_SERVICE_ACCOUNT
                            - NO_AUTH
                            - BASIC_WITH_JWT
                            - CALCOM_AUTH
                            - SERVICE_ACCOUNT
                            - SAML
                            - DCR_OAUTH
                            - CIMD_OAUTH
                            - S2S_OAUTH2
                          description: >-
                            The authentication scheme used (e.g., OAuth2, API
                            Key, etc.)
                        is_composio_managed:
                          type: boolean
                          description: >-
                            Whether this authentication configuration is managed
                            by Composio or the user
                        credentials:
                          type: object
                          additionalProperties: {}
                          description: >-
                            The authentication credentials (tokens, keys, etc.)
                            - may be partially hidden for security
                        proxy_config:
                          type: object
                          nullable: true
                          properties:
                            proxy_url:
                              type: string
                              format: uri
                              description: The url of the auth proxy
                            proxy_auth_key:
                              type: string
                              description: The auth key for the auth proxy
                          required:
                            - proxy_url
                        status:
                          type: string
                          enum:
                            - ENABLED
                            - DISABLED
                          description: Current status of the authentication configuration
                        created_by:
                          type: string
                          description: >-
                            The identifier of the user who created the auth
                            config
                        created_at:
                          type: string
                          description: ISO 8601 date-time when the auth config was created
                        last_updated_at:
                          type: string
                          description: >-
                            ISO 8601 date-time when the auth config was last
                            updated
                        no_of_connections:
                          type: number
                          description: >-
                            The number of active connections using this auth
                            config
                        expected_input_fields:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                              displayName:
                                type: string
                              default:
                                type: string
                                nullable: true
                              type:
                                type: string
                              description:
                                type: string
                              required:
                                type: boolean
                              is_secret:
                                type: boolean
                                description: >-
                                  Whether this field holds a secret/credential
                                  value. Clients use it to decide whether to
                                  mask the input.
                              legacy_template_name:
                                type: string
                              user_visible:
                                type: boolean
                                description: >-
                                  Whether this field is shown to the end user in
                                  the hosted connect flow. Fields with `false`
                                  are never required — the field's `default`
                                  applies unless the developer supplies a value
                                  on the auth config (e.g. as a shared
                                  credential).
                              is_available_as_shared_credentials:
                                type: boolean
                            required:
                              - name
                              - displayName
                              - type
                              - description
                              - required
                              - user_visible
                          description: Fields expected during connection initialization
                        restrict_to_following_tools:
                          type: array
                          items:
                            type: string
                          description: >-
                            List of tool slugs this auth config is restricted to
                            use with. DEPRECATED: use [Get required
                            scopes](/reference/api-reference/toolkits/recommendToolkitScopes)
                            to resolve the scopes for the tools you need, then
                            pass those scopes in `credentials.scopes`.
                          deprecated: true
                        tool_access_config:
                          type: object
                          properties:
                            tools_for_connected_account_creation:
                              type: array
                              items:
                                type: string
                              default: []
                              description: >-
                                Tools used to generate the minimum required
                                scopes for the auth config (only valid for
                                OAuth). If passed, this will update the scopes.
                                DEPRECATED: use [Get required
                                scopes](/reference/api-reference/toolkits/recommendToolkitScopes)
                                to resolve the scopes for the tools you need,
                                then pass those scopes in `credentials.scopes`.
                              deprecated: true
                            tools_available_for_execution:
                              type: array
                              items:
                                type: string
                              default: []
                              description: >-
                                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. DEPRECATED: use [Get required
                                scopes](/reference/api-reference/toolkits/recommendToolkitScopes)
                                to resolve the scopes for the tools you need,
                                then pass those scopes in `credentials.scopes`.
                              deprecated: true
                          description: >-
                            DEPRECATED: use [Get required
                            scopes](/reference/api-reference/toolkits/recommendToolkitScopes)
                            to resolve the scopes for the tools you need, then
                            pass those scopes in `credentials.scopes`.
                          deprecated: true
                        shared_credentials:
                          type: object
                          additionalProperties: {}
                          description: >-
                            Shared credentials that will be inherited by all
                            connected accounts using this auth config.
                            DEPRECATED: use `shared_connection_fields` instead.
                            It takes the same value and behaves the same way.
                          deprecated: true
                        shared_connection_fields:
                          type: object
                          additionalProperties: {}
                          description: >-
                            Connection field values inherited by every connected
                            account created under this auth config. Same value
                            as shared_credentials; secret values are redacted.
                        is_enabled_for_tool_router:
                          type: boolean
                          description: Whether this auth config is enabled for tool router
                      required:
                        - id
                        - uuid
                        - type
                        - toolkit
                        - name
                        - status
                        - no_of_connections
                        - tool_access_config
                  next_cursor:
                    type: string
                    nullable: true
                  total_pages:
                    type: number
                  current_page:
                    type: number
                  total_items:
                    type: number
                required:
                  - items
                  - total_pages
                  - current_page
                  - total_items
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
        - UserApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key
    UserApiKeyAuth:
      type: apiKey
      in: header
      name: x-user-api-key
      description: Your Composio user API key for user-scoped endpoints.
      x-default: your-user-api-key

````