> ## 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 Extend twin provision TTL

> Extend an active twin session

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

Reschedules the environment cleanup for an active twin provision so the session stays alive longer. 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`. |

**Request body**

| Field         | Type      | Required | Description                                          |
| ------------- | --------- | -------- | ---------------------------------------------------- |
| `ttl_minutes` | `integer` | No       | New cleanup delay in minutes, 1-480. Defaults to 60. |

**Response**

```json theme={null}
{"status": "extended", "ttl_minutes": 60}
```

**Errors**

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