Auth Configs

List authentication configurations with optional filters

Changed on

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.

get/api/v3.1/auth_configs

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/auth_configs
  • Auth
    • API key in header x-api-key
    • or API key in header x-user-api-key

Query parameters

string
OR
boolean
toolkit_slugstring

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

deprecated_app_idstring

DEPRECATED: This parameter will be removed in a future version. Please use toolkit_slug instead.

The app id to filter by

deprecated_statusstring

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

show_disabledboolean nullable

Show disabled auth configs

searchstring

Search auth configs by name or id

limitnumber nullable

Number of items per page, max allowed is 200

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

Successfully fetched auth configs

next_cursorstring nullable
total_pagesnumber required
current_pagenumber required
total_itemsnumber required

Changes

  • 98956f31abf3Revision changes
    • breaking

      the /// response's property type changed from no type to object for status

    • warning

      added the new CIMD_OAUTH enum value to the // response property for the response status

    • info

      api operation id getV3_1AuthConfigs removed and replaced with getAuthConfigs

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      response property items/items/shared_credentials deprecated

    • info

      response property items/items/tool_access_config deprecated

    • info

      response property items/items/tool_access_config/tools_available_for_execution deprecated

    • info

      response property items/items/tool_access_config/tools_for_connected_account_creation deprecated

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

  • 1d3aac1128efRevision changes
    • warning

      removed the optional property // from the response with the status