Create Run

Execute a test run

POST /v1/runs

cURL

curl -X POST https://api.playgent.com/v1/runs \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "test_case_id": "tc_xyz789",
    "config": {
      "parallel": true,
      "max_retries": 2,
      "timeout_ms": 30000
    }
  }'

Response

{
  "run_id": "run_def456",
  "status": "queued",
  "test_case_count": 1,
  "estimated_duration_s": 45,
  "webhook_url": "wss://api.playgent.com/v1/runs/run_def456/stream"
}

Execute one or more test cases against an agent. Supports running by test case ID, multiple IDs, or tags.

test_case_id · string

Single test case ID to run

test_case_ids · array

Multiple test case IDs to run

tags · array

Run all test cases with these tags

agent_id · string

Override agent for comparison testing

config · object

Run configuration

Show properties

parallel · boolean

Run test cases in parallel (default: true)

max_retries · integer

Maximum retry attempts on failure (default: 0)

timeout_ms · integer

Timeout per turn in milliseconds (default: 30000)

run_id · string · required

Unique run identifier

status · string · required

Run status: queued, running, completed, failed

test_case_count · integer · required

Number of test cases in this run

estimated_duration_s · integer · required

Estimated duration in seconds

webhook_url · string · required

WebSocket URL for real-time progress streaming

cURL

curl -X POST https://api.playgent.com/v1/runs \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "test_case_id": "tc_xyz789",
    "config": {
      "parallel": true,
      "max_retries": 2,
      "timeout_ms": 30000
    }
  }'

Response

{
  "run_id": "run_def456",
  "status": "queued",
  "test_case_count": 1,
  "estimated_duration_s": 45,
  "webhook_url": "wss://api.playgent.com/v1/runs/run_def456/stream"
}