Skip to main content

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 are running instances of an Environment. When you create a playground (or start a benchmark run), Verial provisions live 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.

Endpoints

MethodEndpointDescription
GET/playgroundsList playgrounds
POST/playgroundsCreate a playground
GET/playgrounds/{id}Get playground details
POST/playgrounds/{id}/teardownTear down a playground

Playground Object

FieldTypeDescription
idstringUnique identifier
environment_idstringSource Environment
statusstringCurrent status (provisioning, active, teardown, etc.)
organization_idstringParent organization
created_atdatetimeCreation timestamp
updated_atdatetimeLast 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 })