Sign in
Auth Configs

Get single authentication configuration by ID

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

get/api/v3.1/auth_configs/{nanoid}

Path parameters

nanoidstring authConfigId required

The unique identifier of the authentication configuration to retrieve

The unique identifier of the authentication configuration to retrieve

Response

Successfully fetched auth config

idstring authConfigId required

The unique ID of the authentication configuration

uuidstring required

The UUID of the authentication configuration (for backward compatibility)

type'default' | 'custom' required

The type of the authentication configuration (custom or default)

namestring 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_managedboolean

Whether this authentication configuration is managed by Composio or the user

credentialsobject

The authentication credentials (tokens, keys, etc.) - may be partially hidden for security

status'ENABLED' | 'DISABLED' required

Current status of the authentication configuration

created_bystring

The identifier of the user who created the auth config

created_atstring

ISO 8601 date-time when the auth config was created

last_updated_atstring

ISO 8601 date-time when the auth config was last updated

no_of_connectionsnumber required

The number of active connections using this auth config

restrict_to_following_toolsstring[]

Use tool_access_config instead. This field will be deprecated in the future.

shared_credentialsobject

[EXPERIMENTAL] Shared credentials that will be inherited by all connected accounts using this auth config

is_enabled_for_tool_routerboolean

Whether this auth config is enabled for tool router

Changes

Changed in 6 of the 61 revisions of this API.15