COcomposiohq
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/auth_configs

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3/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

  • fc87d65c53bfRevision changes
    • info

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

    • info

      response property items/items/shared_credentials deprecated

  • a66b5850bf7bRevision changes
    • 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