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

# Get Agent

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

Fetch one agent's full tree: base config, funnel statuses, custom fields, and custom tools.

## Path Parameters

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

## Responses

### `200` — Successful response

```json theme={null}
{
  "workflow": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Sales Agent",
    "description": "Qualifies inbound leads and books demo calls",
    "goal_type": "appointment",
    "global_prompt": "You are Iris, a friendly sales rep for Acme...",
    "is_paused": false,
    "is_active": true,
    "timezone": "America/Santiago",
    "created_at": "2026-01-15T09:00:00Z",
    "updated_at": "2026-02-01T12:00:00Z",
    "statuses": [
      { "key": "new", "label": "New", "category": "active", "is_initial": true, "is_terminal": false, "sort_order": 0 },
      { "key": "won", "label": "Won", "category": "won", "is_initial": false, "is_terminal": true, "sort_order": 1 }
    ],
    "fields": [
      { "key": "budget", "label": "Budget", "type": "number", "required": false }
    ],
    "tools": [
      { "name": "check_availability", "is_active": true }
    ]
  }
}
```

### Response Fields — Workflow

| Field           | Type           | Description                                                                                                                                                     |
| --------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | string (uuid)  | Agent identifier                                                                                                                                                |
| `name`          | string         | Agent name                                                                                                                                                      |
| `description`   | string \| null | Agent description                                                                                                                                               |
| `goal_type`     | string         | See [Create Agent](/docs/en/api/workflows/create-workflow) for valid values                                                                                     |
| `global_prompt` | string         | The base prompt                                                                                                                                                 |
| `is_paused`     | boolean        | Whether the agent is currently paused                                                                                                                           |
| `is_active`     | boolean        | Whether the agent is active (vs. archived)                                                                                                                      |
| `timezone`      | string         | IANA timezone used for cadence scheduling                                                                                                                       |
| `statuses`      | array          | Funnel statuses, ordered by `sort_order`                                                                                                                        |
| `fields`        | array          | Custom lead fields this agent collects                                                                                                                          |
| `tools`         | array          | Custom tools this agent can call, with `name` and `is_active` only — see [List Workflow Tools](/docs/en/api/workflow-tools/list-workflow-tools) for full detail |

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