> ## Documentation Index
> Fetch the complete documentation index at: https://docs.60db.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Control Simulation

> Pause, resume or cancel a simulation run

> [!NOTE]
>
> AI Simulation needs an active **Pro** or **Business** plan. `pause` and `cancel` work on any plan, so a run can be stopped after the plan ends; `resume` needs Pro or Business and otherwise returns `403 POLICY_DENY`.

Pause, resume or cancel a run. Calls that already started finish and are charged. Calls still waiting do not start after a cancel.

Control works when the plan is not active, so you can always stop spending.

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

### Path

**runId** `string` *required*

The simulation run `run_id` (UUID) from [Start a simulation](https://docs.60db.ai/api-reference/agents/start-simulation.md)

**action** `string` *required*

`pause`, `resume` or `cancel`. Any other value returns `404`

## Response

**200 OK**.

```json theme={null}
{ "run_id": "6f1c1e2a-3333-4000-8000-000000000001", "state": "paused" }
```

## Errors

| Status | Code | Meaning |
| - | - | - |
| 403 | `POLICY_DENY` | Your role cannot do this, `resume` without an active Pro or Business plan, or the API key lacks the `agents` scope |
| 404 | `RUN_NOT_FOUND` | No run with this ID in your workspace |

## Example

```bash cURL theme={null}
curl -X POST https://api.60db.ai/agents/simulations/RUN_ID/pause \
  -H "Authorization: Bearer your-api-key"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.