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

# POST Tear down twin provision

> Destroy a twin session immediately

```bash theme={null}
POST /validate/twins/provision/{run_id}/teardown
```

Cancels the run and queues environment cleanup immediately. The run must be in `ready`, `provisioning`, or `queued` status.

**Path parameters**

| Field    | Type     | Description                                                         |
| -------- | -------- | ------------------------------------------------------------------- |
| `run_id` | `string` | Provisioning run id returned from `POST /validate/twins/provision`. |

**Response**

```json theme={null}
{"status": "cleaning_up", "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"}
```

**Errors**

| Status | Description                                                                       |
| ------ | --------------------------------------------------------------------------------- |
| `400`  | `run_id` is not a valid UUID, or the run is not in a state that can be torn down. |
| `404`  | No run with that id exists for the authenticated user.                            |