---
title: "Create Episode Queue"
method: POST
path: "/review/episode-queues"
tags: ["review"]
---

# Create Episode Queue

`POST /review/episode-queues`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/review/episode-queues`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- EpisodeQueueIn
  - `dataset_id` string, uuid, required
  - `name` string, required
  - `question` string, required
  - `choices` string[], required
  - `size` integer, required
  - `filters` Filters
    - `version` integer, nullable
    - `task` string, nullable
    - `site` string, nullable
    - `robot` string, nullable
    - `operator` string, nullable
    - `outcome` 'success' | 'failure' | 'incomplete' | 'unknown', nullable
    - `failure_stage` string, nullable
    - `min_interventions` integer, nullable
    - `quality_min` number, nullable
    - `quality_max` number, nullable
    - `tag` string, nullable
    - `episode_id` string, nullable

## Response `201`

Successful Response

- EpisodeQueue
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `dataset_id` string, uuid, required
  - `name` string, required
  - `question` string, required
  - `choices` string[], required
  - `filters` object, required
  - `created_by_kind` string, required
  - `created_by` string, required
  - `created_at` string, date-time, required
  - `size` integer, required
  - `available` integer, required
  - `labelled` integer, required
  - `mine` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)