---
title: "Create Lab Runs"
method: POST
path: "/api/v1/lab/runs"
tags: ["prompt-lab"]
---

# Create Lab Runs

`POST /api/v1/lab/runs`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/lab/runs`
- Auth: none declared

Submit lab runs for one or more playbooks × tasks.

This is the core Prompt Lab execution endpoint. Pass multiple playbook_ids
to compare playbooks side-by-side on the same tasks.

## Request body

- LabRunBatchCreate: Execute multiple lab runs at once — for side-by-side comparison.
  - `playbook_ids` string[], required
  - `task_ids` string[], required
  - `experiment_id` string, uuid, required

## Response `202`

Successful Response

- LabRunRead[]
  - `id` string, uuid, required
  - `experiment_id` string, uuid, nullable, required
  - `playbook_id` string, uuid, required
  - `task_id` string, uuid, required
  - `status` string, required
  - `started_at` string, date-time, nullable, required
  - `completed_at` string, date-time, nullable, required
  - `latency_ms` integer, nullable, required
  - `success` boolean, nullable, required
  - `output` string, nullable, required
  - `error_message` string, nullable, required
  - `input_tokens` integer, nullable, required
  - `output_tokens` integer, nullable, required
  - `total_cost_usd` number, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)