POST Extend twin provision TTL

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

{
  "status": "extended",
  "ttl_minutes": 60,
  "expires_at": "2026-07-30T18:45:00+00:00"
}

Use the returned expires_at value as the new cleanup deadline. 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.
`503`	Cleanup could not be rescheduled. The previous expiration still applies.

⌘I

Overview

Twins

Scenarios

Runner

Tests

PR test runs

Logs and artifacts

POST Extend twin provision TTL