# Start a screen recording

`POST /v1/sandboxes/{sandbox}/recordings`

**In this build:** Works on the simulator or a real VM. Needs a real machine. The simulator returns placeholder results.

**Scope:** `desktop`

**CLI:** `harebox record start`

## Response: 202

`Recording`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `status` (required) | `string` | One of: `recording`, `processing`, `ready`, `failed` |
| `url` | `string or null` |  |
| `include_input_log` | `boolean` |  |
| `path` | `string or null` | Where the MP4 is inside the sandbox. Read it with `harebox file read` or a download URL. |
| `bytes` | `integer or null` |  |

Errors follow [one format](../errors.html).