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

# Resume Automation

<span class="badge--post">POST</span> <code class="endpoint-url">/leads/\{id}/automation/resume</code>

Resumes AI automation for a lead's workflow run after it was stopped. The AI will respond to messages again.

Cadence is **not** resumed by default. Set `resume_cadence: true` if you want the automated outreach sequence to restart.

Authenticate every request with the `X-API-Key` header. See [Authentication](/docs/en/api/authentication).

## Path Parameters

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

## Request Body

| Field            | Type          | Required | Description                                                   |
| ---------------- | ------------- | -------- | ------------------------------------------------------------- |
| `workflow_id`    | string (uuid) | **Yes**  | Workflow to resume automation for                             |
| `resume_cadence` | boolean       | No       | Whether to also resume the cadence sequence. Default: `false` |

## Responses

### `200` Automation resumed

```json theme={null}
{
  "success": true,
  "workflow_run_id": "run-uuid",
  "cadence_resumed": false
}
```

If already running:

```json theme={null}
{
  "success": true,
  "already_running": true,
  "workflow_run_id": "run-uuid"
}
```

### Response Fields

| Field             | Type    | Description                                            |
| ----------------- | ------- | ------------------------------------------------------ |
| `workflow_run_id` | string  | The workflow run that was resumed                      |
| `cadence_resumed` | boolean | Whether cadence was also resumed                       |
| `already_running` | boolean | Returned if automation was already active (idempotent) |

### `400` Missing workflow\_id

```json theme={null}
{
  "error": "workflow_id is required"
}
```

### `404` No active run found

```json theme={null}
{
  "error": "No active workflow run found for this lead and workflow"
}
```

### `401` Authentication error

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