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

# Historial de Prompts

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

Lee el historial de versiones del prompt de un agente — cada snapshot tomado cuando cambió el prompt base, un override de canal, o la estructura del funnel.

## Parámetros de Ruta

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

## Parámetros de Consulta

| Parámetro | Tipo    | Requerido | Descripción                                                                       |
| --------- | ------- | --------- | --------------------------------------------------------------------------------- |
| `limit`   | integer | No        | Máximo de versiones a devolver, más nuevas primero. Por defecto `20`, máximo `50` |

## Respuestas

### `200` — Respuesta exitosa

```json theme={null}
{
  "success": true,
  "versions": [
    {
      "version_number": 4,
      "global_prompt": "You are Iris, a friendly sales rep for Acme...",
      "channel_prompts": { "whatsapp": "Keep replies under 2 sentences." },
      "changed_fields": ["global_prompt"],
      "changed_by_email": "founder@acme.com",
      "change_source": "api",
      "change_note": null,
      "activated_at": "2026-02-01T12:00:00Z",
      "superseded_at": null,
      "created_at": "2026-02-01T12:00:00Z"
    }
  ]
}
```

### Campos de Respuesta — PromptVersion

| Campo              | Tipo                       | Descripción                                                                                                                                 |
| ------------------ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `version_number`   | integer                    | Número secuencial de versión                                                                                                                |
| `global_prompt`    | string                     | El prompt base en esta versión                                                                                                              |
| `channel_prompts`  | object                     | Overrides por canal en esta versión                                                                                                         |
| `changed_fields`   | string\[]                  | Qué campos cambiaron en esta versión                                                                                                        |
| `changed_by_email` | string \| null             | Quién hizo el cambio                                                                                                                        |
| `change_source`    | string                     | De dónde vino el cambio, ej. `dashboard`, `api`, `training`                                                                                 |
| `change_note`      | string \| null             | Anotación opcional (ver [Actualizar Estructura](/docs/es/api/workflows/update-workflow-structure) para editar estructura junto con prompts) |
| `activated_at`     | string (date-time) \| null | Cuándo esta versión pasó a estar activa                                                                                                     |
| `superseded_at`    | string (date-time) \| null | Cuándo una versión posterior la reemplazó                                                                                                   |
| `created_at`       | string (date-time)         | Cuándo se registró esta versión                                                                                                             |

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