> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Client Tools

<span class="badge--get">GET</span> <code class="endpoint-url">/client-tools</code>

Lista el catálogo reutilizable de tools del cliente. Una tool del catálogo se puede asignar a varios agentes con [Asignar Tool a Workflow](/docs/es/api/client-tools/assign-tool-to-workflow), donde hereda y se mantiene sincronizada con la fila del catálogo. Para una tool que debe vivir solo en un agente, usa [Crear Workflow Tool](/docs/es/api/workflow-tools/create-workflow-tool) en su lugar.

## Respuestas

### `200` — Respuesta exitosa

```json theme={null}
{
  "success": true,
  "tools": [
    {
      "id": "7c1b2c3d-0000-4000-8000-000000000002",
      "client_id": "3f9a1111-0000-4000-8000-000000000099",
      "name": "check_subscription",
      "description": "Checks whether the lead has an active subscription",
      "url": "https://api.acme.com/subscriptions/status",
      "method": "GET",
      "timeout_ms": 10000,
      "parameters": { "type": "object", "properties": {} },
      "headers": {},
      "query_parameters": {},
      "speak_during_execution": true,
      "speak_after_execution": true,
      "response_variables": {},
      "is_active": true,
      "sort_order": 0,
      "execution_message_type": null,
      "execution_message_description": null,
      "llm_response_fields": null,
      "created_at": "2026-07-15T12:00:00.000Z",
      "updated_at": "2026-07-15T12:00:00.000Z"
    }
  ]
}
```

### Campos de Respuesta — ClientTool

| Campo                           | Tipo               | Descripción                                                                  |
| ------------------------------- | ------------------ | ---------------------------------------------------------------------------- |
| `id`                            | string (uuid)      | Identificador de la tool                                                     |
| `client_id`                     | string (uuid)      | Identificador de tu cliente                                                  |
| `name`                          | string             | Nombre en snake\_case que el agente usa para llamar la tool. Inmutable       |
| `description`                   | string             | Le indica al agente qué hace la tool y cuándo usarla. Máximo 1024 caracteres |
| `url`                           | string             | Endpoint que llama la tool                                                   |
| `method`                        | string             | Método HTTP: `GET`, `POST`, `PUT`, `PATCH`, o `DELETE`                       |
| `timeout_ms`                    | integer            | Limitado entre 1,000 y 120,000                                               |
| `parameters`                    | object             | Objeto estilo JSON-schema que describe los argumentos de llamada de la tool  |
| `headers`                       | object             | Headers estáticos enviados en cada llamada                                   |
| `query_parameters`              | object             | Query params estáticos enviados en cada llamada                              |
| `speak_during_execution`        | boolean            | Hace que el agente de voz hable mientras la llamada está en curso            |
| `speak_after_execution`         | boolean            | Hace que el agente de voz hable una vez que la llamada retorna               |
| `response_variables`            | object             | Mapa de campos de la respuesta capturados como variables de la llamada       |
| `is_active`                     | boolean            | Si el agente puede llamar esta tool actualmente                              |
| `sort_order`                    | integer            | Orden de visualización                                                       |
| `execution_message_type`        | string \| null     | Ej. `"prompt"`                                                               |
| `execution_message_description` | string \| null     | Qué dice el agente durante/después de la ejecución                           |
| `llm_response_fields`           | string\[] \| null  | Lista de campos de la respuesta que el agente puede ver                      |
| `created_at`                    | string (date-time) | Marca de tiempo de creación                                                  |
| `updated_at`                    | string (date-time) | Marca de tiempo de la última actualización                                   |

### `401` — Error de autenticación

Ver [Autenticación](/docs/es/api/authentication).

### `500` — Error interno del servidor