> ## 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.

# Playgrounds

> Running environment instances with live sandboxes.

Playgrounds are running instances of an [Environment](/api-reference/resources/environments). When you create a playground (or start a benchmark run), Verial provisions live [Sandboxes](/api-reference/resources/sandboxes) for each simulator in the environment, complete with credentials and loaded data. Each task run executes its rollout inside a playground, and the verification engine reads the playground's final sandbox state to score [criteria](/api-reference/resources/criteria).

## Endpoints

| Method | Endpoint                     | Description            |
| ------ | ---------------------------- | ---------------------- |
| `GET`  | `/playgrounds`               | List playgrounds       |
| `POST` | `/playgrounds`               | Create a playground    |
| `GET`  | `/playgrounds/{id}`          | Get playground details |
| `POST` | `/playgrounds/{id}/teardown` | Tear down a playground |

## Playground Object

| Field             | Type     | Description                                                 |
| ----------------- | -------- | ----------------------------------------------------------- |
| `id`              | string   | Unique identifier                                           |
| `environment_id`  | string   | Source [Environment](/api-reference/resources/environments) |
| `status`          | string   | Current status (provisioning, active, teardown, etc.)       |
| `organization_id` | string   | Parent organization                                         |
| `created_at`      | datetime | Creation timestamp                                          |
| `updated_at`      | datetime | Last modification timestamp                                 |

## SDK Example

```typescript theme={null}
// Create a playground from an environment
const playground = await verial.playgrounds.create({
  environmentId: 'env_abc123',
})

// List all playgrounds
const playgrounds = await verial.playgrounds.list()

// Get playground details (includes sandbox credentials)
const details = await verial.playgrounds.get({ id: playground.id })

// Tear down when done
await verial.playgrounds.teardown({ id: playground.id })
```