Playgrounds are running instances of an Environment. When you create a playground, Verial provisions live Sandboxes for each simulator in the environment, complete with credentials and loaded data.
Endpoints not yet in OpenAPI spec.
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 |
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
// 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 })
