> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verial.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# verial playgrounds

> Instantiate and tear down playgrounds from the command line.

The `verial playgrounds` commands manage [Playgrounds](/api-reference/resources/playgrounds) — instantiated environments with live infrastructure (FHIR store provisioned, phone numbers leased, seed data loaded). Use them to spin up an environment on demand for interactive testing or CI runs.

Authentication is required. See [verial auth](/cli/auth).

## Subcommands

| Command                       | Description                                       |
| ----------------------------- | ------------------------------------------------- |
| `verial playgrounds list`     | List playgrounds in your organization.            |
| `verial playgrounds create`   | Instantiate an environment as a playground.       |
| `verial playgrounds get`      | Get a single playground by ID.                    |
| `verial playgrounds teardown` | Tear down a playground and release its resources. |

## verial playgrounds list

List playgrounds visible to your organization. Supports cursor pagination.

Synopsis:

```bash theme={null}
verial playgrounds list [--cursor <cursor>] [--limit <n>]
```

Options:

| Flag                | Description                                   | Default        |
| ------------------- | --------------------------------------------- | -------------- |
| `--cursor <cursor>` | Pagination cursor returned from a prior page. | —              |
| `--limit <limit>`   | Items per page.                               | Server default |

REST equivalent: [GET /playgrounds](/api-reference/resources/playgrounds).

## verial playgrounds create

Provision a playground from an environment: create the FHIR store, lease phone numbers, and load seed data.

Synopsis:

```bash theme={null}
verial playgrounds create --environment-id <id>
```

Options:

| Flag                    | Description                 | Required |
| ----------------------- | --------------------------- | -------- |
| `--environment-id <id>` | Environment to instantiate. | Yes      |

Example:

```bash theme={null}
verial playgrounds create --environment-id env_clxyz123
```

REST equivalent: [POST /playgrounds](/api-reference/resources/playgrounds).

## verial playgrounds get

Fetch a single playground, including its provisioned services and credentials.

Synopsis:

```bash theme={null}
verial playgrounds get --id <id>
```

Example:

```bash theme={null}
verial playgrounds get --id pg_clxyz456
```

REST equivalent: [GET /playgrounds/:id](/api-reference/resources/playgrounds).

## verial playgrounds teardown

Tear down a playground: delete the FHIR store, release phone numbers, and mark it inactive.

Synopsis:

```bash theme={null}
verial playgrounds teardown --id <id>
```

Example:

```bash theme={null}
verial playgrounds teardown --id pg_clxyz456
```

REST equivalent: [DELETE /playgrounds/:id](/api-reference/resources/playgrounds).

## Next Steps

<CardGroup cols={2}>
  <Card title="Playgrounds" icon="flask" href="/api-reference/resources/playgrounds">
    Playground lifecycle and provisioned services.
  </Card>

  <Card title="Environments" icon="hospital" href="/cli/environments">
    Define the environment a playground instantiates.
  </Card>
</CardGroup>