> ## 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.

# List Workflow Tools

<span class="badge--get">GET</span> <code class="endpoint-url">/workflows/:id/tools</code>

List the custom HTTP tools an agent can call — its own hand-rolled functions on top of the built-in ones.

## Path Parameters

| Parameter | Type          | Required | Description |
| --------- | ------------- | -------- | ----------- |
| `id`      | string (uuid) | **Yes**  | Agent ID    |

## Responses

### `200` — Successful response

```json theme={null}
{
  "success": true,
  "tools": [
    {
      "id": "9a1b2c3d-0000-4000-8000-000000000001",
      "name": "check_availability",
      "description": "Checks open slots on the sales calendar for a given day",
      "method": "GET",
      "url": "https://api.acme.com/availability",
      "is_active": true,
      "available_in_statuses": ["qualified"],
      "auto_run_on_entry": false,
      "call_once": false,
      "sort_order": 0
    }
  ]
}
```

### Response Fields — WorkflowTool

| Field                   | Type              | Description                                                               |
| ----------------------- | ----------------- | ------------------------------------------------------------------------- |
| `id`                    | string (uuid)     | Tool identifier                                                           |
| `name`                  | string            | snake\_case name the agent references when calling the tool               |
| `description`           | string            | Tells the agent what the tool does and when to use it                     |
| `method`                | string            | HTTP method the tool calls: `GET`, `POST`, `PUT`, `PATCH`, or `DELETE`    |
| `url`                   | string            | Endpoint the tool calls                                                   |
| `is_active`             | boolean           | Whether the agent can currently call this tool                            |
| `available_in_statuses` | string\[] \| null | Funnel status keys where this tool is offered. `null` means every status  |
| `auto_run_on_entry`     | boolean           | Whether the tool runs automatically when a lead enters an eligible status |
| `call_once`             | boolean           | Whether the tool can only be called once per lead                         |
| `sort_order`            | integer           | Display order                                                             |

### `401` — Authentication error

See [Authentication](/docs/en/api/authentication).

### `404` — Not found

```json theme={null}
{
  "error": "Not found",
  "message": "Workflow not found"
}
```

### `500` — Internal server error