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

# Get single authentication configuration by ID

> Retrieves detailed information about a specific authentication configuration using its unique identifier.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v3.1/auth_configs/{nanoid}
openapi: 3.1.0
info:
  version: 3.1.0
  title: Composio Platform API v3.1
  description: >-
    Composio v3.1 API — all endpoints available under /api/v3.1/. Tool endpoints
    default to the latest tool version.
  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: Projects
    description: Projects API endpoints.
    x-group: Projects
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Webhook Events
    description: Events delivered by Composio to your registered webhook endpoints
    x-group: Webhook Events
paths:
  /api/v3.1/auth_configs/{nanoid}:
    get:
      tags:
        - Auth Configs
      summary: Get single authentication configuration by ID
      description: >-
        Retrieves detailed information about a specific authentication
        configuration using its unique identifier.
      operationId: getAuthConfigsByNanoid
      parameters:
        - schema:
            type: string
            format: authConfigId
            description: >-
              The unique identifier of the authentication configuration to
              retrieve
          required: true
          description: >-
            The unique identifier of the authentication configuration to
            retrieve
          name: nanoid
          in: path
      responses:
        '200':
          description: Successfully fetched auth config
          content:
            application/json:
              schema:
                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
                          - 'null'
                        description: >-
                          URL to a guide page with authentication setup
                          instructions
                      auth_hint_url:
                        type:
                          - string
                          - 'null'
                        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
                      - 'null'
                    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
                            - 'null'
                        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
        '400':
          description: Bad request - Invalid auth config ID format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found - Auth configuration does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error - Something went wrong on the server
          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

````