POST Provision twins

POST /validate/twins/provision

Provision ephemeral twin instances without deploying user code. This is the core “twins only” API. Request body

Field	Type	Required	Description
`twins`	`array<string>`	Yes	Twin names from the catalog.
`ttl_minutes`	`integer`	No	Session TTL, 1-480 minutes. Defaults to 60.
`scenario_id`	`string`	No	Scenario UUID or preset id used to seed the twins.
`scenario_prompt`	`string`	No	Natural-language seed prompt. Ignored when `scenario_id` is provided.
`public`	`boolean`	No	Whether returned base URLs are public drop-in hosts. Defaults to `true`.

Response

{
  "run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Poll Get twin provision status until status is ready. Save the returned expires_at deadline and stop calling twin URLs when the session expires.

⌘I

Overview

Twins

Scenarios

Runner

Tests

PR test runs

Logs and artifacts

POST Provision twins