---
title: "List connectors"
method: GET
path: "/agent_connectors"
tags: ["Business Agent - Knowledge - Connectors"]
---

# List connectors

`GET /agent_connectors`

Retrieve a list of all connectors for the specified entity.

## Headers

- `X-API-Version` '2.0.0'

## Response `200`

A list of all connectors

- KnowledgeConnectorsBizAIOmniChannelConnectorResponse[]
  - `auth_config` KnowledgeConnectorsBizAIOmniChannelConnectorAuthConfig — Authentication configuration for this connector
    - `api_key` KnowledgeConnectorsBizAIOmniChannelConnectorApiKeyAuthConfig — API key configuration. Provide only when auth_type is API_KEY.
      - `body_params` KnowledgeConnectorsBizAIOmniChannelConnectorApiKeyParam[]
        - `field_name` string, required
        - `prefix` string
        - `value` string, required
      - `headers` KnowledgeConnectorsBizAIOmniChannelConnectorApiKeyParam[]
        - `field_name` string, required
        - `prefix` string
        - `value` string, required
      - `query_params` KnowledgeConnectorsBizAIOmniChannelConnectorApiKeyParam[]
        - `field_name` string, required
        - `prefix` string
        - `value` string, required
    - `oauth2_client_credentials` KnowledgeConnectorsBizAIOmniChannelConnectorOAuth2ClientCredentialsAuthConfig — OAuth 2.0 client credentials configuration. Provide only when auth_type is OAUTH2_CLIENT_CREDENTIALS.
      - `client_id` string, required
      - `client_secret` string, required
      - `scopes_to_request` string[], required
      - `token_request_content_type` string
      - `token_url` string, required
  - `auth_type` 'OAUTH2' | 'OAUTH2_CLIENT_CREDENTIALS' | 'API_KEY' | 'BASIC' | 'CUSTOM' | 'NONE', required
  - `base_url` string, required
  - `connection_status` KnowledgeConnectorsBizAIOmniChannelConnectorConnectionStatus, required — Connection status information
    - `error_message` string
    - `status` 'PENDING_OAUTH' | 'ACTIVE' | 'EXPIRED' | 'ERROR', required
  - `description` string, required
  - `id` string, required
  - `mtls_config` KnowledgeConnectorsBizAIOmniChannelConnectorMtlsConfig — mTLS certificate metadata and PEM content (private key is never exposed)
    - `ca_certificate` string
    - `client_certificate` string
    - `expires_at` integer
    - `fingerprint` string
    - `has_certificate` boolean, required
    - `subject` string
  - `name` string, required
  - `user_auth_injection_config` KnowledgeConnectorsBizAIOmniChannelConnectorUserAuthInjectionConfig — Configuration for injecting user auth tokens into tool requests
    - `field_name` string, required
    - `location` 'body' | 'headers' | 'path' | 'query', required
    - `prefix` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `429` — Too many requests
- `500` — Server error

---

[API](https://skmtc.dev/360dialog/apis/messaging-api.md) · [All operations](https://skmtc.dev/360dialog/apis/messaging-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/360dialog/messaging-api/revisions/74b31f9f8610/schema)