> ## 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 Create a scenario

> Create reusable twin seed data

```bash theme={null}
POST /scenarios
```

Create a scenario from explicit seed JSON or a natural-language prompt.

**Request body**

| Field         | Type            | Required    | Description                                                                                  |
| ------------- | --------------- | ----------- | -------------------------------------------------------------------------------------------- |
| `name`        | `string`        | Yes         | Scenario name.                                                                               |
| `description` | `string`        | No          | Optional description.                                                                        |
| `prompt`      | `string`        | Conditional | Natural-language description of the desired seed. Required unless `seed_config` is provided. |
| `twins`       | `array<string>` | Conditional | Required when providing `seed_config` without `prompt`.                                      |
| `seed_config` | `object`        | Conditional | Explicit provider seed config. Required unless `prompt` is provided.                         |
| `tags`        | `array<string>` | No          | Scenario tags.                                                                               |