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

# Obtener Agente

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

Obtiene el árbol completo de un agente: configuración base, statuses del funnel, campos personalizados y tools personalizadas.

## Parámetros de Ruta

| Parámetro | Tipo          | Requerido | Descripción   |
| --------- | ------------- | --------- | ------------- |
| `id`      | string (uuid) | **Sí**    | ID del agente |

## Respuestas

### `200` — Respuesta exitosa

```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 }
    ]
  }
}
```

### Campos de Respuesta — Workflow

| Campo           | Tipo           | Descripción                                                                                                                                                                              |
| --------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`            | string (uuid)  | Identificador del agente                                                                                                                                                                 |
| `name`          | string         | Nombre del agente                                                                                                                                                                        |
| `description`   | string \| null | Descripción del agente                                                                                                                                                                   |
| `goal_type`     | string         | Ver [Crear Agente](/docs/es/api/workflows/create-workflow) para los valores válidos                                                                                                      |
| `global_prompt` | string         | El prompt base                                                                                                                                                                           |
| `is_paused`     | boolean        | Si el agente está pausado actualmente                                                                                                                                                    |
| `is_active`     | boolean        | Si el agente está activo (vs. archivado)                                                                                                                                                 |
| `timezone`      | string         | Timezone IANA usado para agendar la cadencia                                                                                                                                             |
| `statuses`      | array          | Statuses del funnel, ordenados por `sort_order`                                                                                                                                          |
| `fields`        | array          | Campos personalizados que este agente recolecta                                                                                                                                          |
| `tools`         | array          | Tools personalizadas que este agente puede llamar, solo con `name` e `is_active` — ver [Listar Workflow Tools](/docs/es/api/workflow-tools/list-workflow-tools) para el detalle completo |

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

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

### `404` — No encontrado

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

### `500` — Error interno del servidor