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

# Actualizar Agente

<span class="badge--patch">PATCH</span> <code class="endpoint-url">/workflows/:id</code>

Renombra un agente, edita su descripción, o **actívalo/pausalo**. Los agentes nacen pausados al [crearse](/docs/es/api/workflows/create-workflow) vía API — esta es la única forma de encenderlos programáticamente.

## Parámetros de Ruta

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

## Cuerpo de la Solicitud

Provee al menos uno de los siguientes.

| Campo         | Tipo    | Requerido | Descripción                               |
| ------------- | ------- | --------- | ----------------------------------------- |
| `is_paused`   | boolean | No        | `false` activa el agente, `true` lo pausa |
| `name`        | string  | No        | Nuevo nombre del agente                   |
| `description` | string  | No        | Nueva descripción del agente              |

## Respuestas

### `200` — Actualizado

```json theme={null}
{
  "success": true,
  "workflow_id": "123e4567-e89b-12d3-a456-426614174000",
  "is_paused": false,
  "pending_runs": 3
}
```

`pending_runs` solo aparece al activar, y refleja los leads cuya cadencia se reanuda de inmediato.

### `400` — Error de validación

```json theme={null}
{
  "error": "Invalid input",
  "message": "Provide is_paused, name or description"
}
```

### `400` — Activación bloqueada

Los agentes con `goal_type: appointment` necesitan al menos un tipo de reunión activo antes de poder activarse:

```json theme={null}
{
  "error": "Activation blocked",
  "message": "Configure at least one active meeting type before activating this workflow."
}
```

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