> ## 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 Provision twins

> Spin up ephemeral digital twins

```bash theme={null}
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**

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

Poll [Get twin provision status](/api-reference/get-get-twin-provision-status) until `status` is `ready`.