> ## Documentation Index
> Fetch the complete documentation index at: https://developers.clay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# workflows runs pause

> Pause an active workflow run.

Pause an active workflow run, stopping execution of future steps. Resume it later with [`clay workflows runs resume`](/cli/reference/workflows-runs-resume).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows runs pause <workflowId> <runId>
```

## Arguments

| Argument     | Description                              |
| ------------ | ---------------------------------------- |
| `workflowId` | Workflow id, e.g. `wf_abc123`. Required. |
| `runId`      | Run id, e.g. `wfr_xyz789`. Required.     |

## Output

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "runId": "wfr_xyz789",
  "status": "paused"
}
```

| Field    | Type       | Description                                         |
| -------- | ---------- | --------------------------------------------------- |
| `runId`  | string     | The paused run.                                     |
| `status` | `"paused"` | Run has been paused; future steps will not execute. |

## Errors

| Code               | Exit | Notes                                                        |
| ------------------ | ---- | ------------------------------------------------------------ |
| `validation_error` | 2    | Run is not in a pausable state (already finished or paused). |
| `not_found`        | 6    | No run with that id under that workflow.                     |
| `auth_forbidden`   | 3    | The API key lacks the `terracotta:cli` scope.                |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows runs pause wf_abc123 wfr_xyz789
clay workflows runs pause wf_abc123 wfr_xyz789 | jq -r '.status'
```