---
title: "List connector tools"
method: GET
path: "/agent_connectors/{connector_id}/tools"
tags: ["Business Agent - Knowledge - Connector Tools"]
---

# List connector tools

`GET /agent_connectors/{connector_id}/tools`

Retrieve a list of all tools for the specified connector.

## Path parameters

- `connector_id` string, required

## Headers

- `X-API-Version` '2.0.0'

## Response `200`

A list of all tools

- KnowledgeConnectorToolsBizAIOmniChannelConnectorToolResponse[]
  - `description` string, required
  - `id` string, required
  - `name` string, required
  - `request_definition` KnowledgeConnectorToolsBizAIOmniChannelConnectorToolRequestDefinition, required — Roundtripped outbound HTTP request definition
    - `body` KnowledgeConnectorToolsBizAIOmniChannelConnectorToolRequestBodyDefinition — Request body definition; omit or set to null when the request has no body
      - `content_type` 'application/json', required
      - `params` object, required
      - `required` string[]
    - `headers` object
    - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH', required
    - `path` string, required
    - `path_parameters` object
    - `query_parameters` object
  - `user_auth_action_config` KnowledgeConnectorToolsBizAIOmniChannelConnectorToolUserAuthActionConfig — Response extraction config for login/refresh user-auth actions
    - `expires_at_path` string
    - `expires_at_type` 'absolute' | 'relative_seconds'
    - `refresh_token_path` string
    - `user_action_tool_type` 'auth' | 'refresh', required
    - `user_auth_token_path` string, required
  - `user_auth_required` boolean, 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)