POST /twin-runs accepts the same request fields.
status is ready. Save the returned expires_at deadline and stop calling twin URLs when the session expires.Twins
POST Provision twins
Spin up ephemeral digital twins
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Spin up ephemeral digital twins
POST /validate/twins/provision
| 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. |
scenario_generation_mode | "fast" or "thorough" | No | Defaults to "fast". Fast prioritizes speed; Thorough handles complex requirements with a longer wait. Only used with scenario_prompt when scenario_id is absent. |
public | boolean | No | Whether returned base URLs are public drop-in hosts. Defaults to true. |
POST /twin-runs accepts the same request fields.
{
"twins": ["slack"],
"scenario_prompt": "A support channel with linked escalation threads and consistent message authors",
"scenario_generation_mode": "thorough"
}
{
"run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
status is ready. Save the returned expires_at deadline and stop calling twin URLs when the session expires.