---
title: "Create Rl Dataset"
method: POST
path: "/llm/rl-datasets"
tags: ["llm"]
---

# Create Rl Dataset

`POST /llm/rl-datasets`

## 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/llm/rl-datasets`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- RlDatasetIn
  - `workspace_id` string, uuid, required
  - `slug` string, required
  - `recipe` 'sql_v3' | 'sql_v2' | 'support_v1' | 'structured_v1' | 'graded_v1' | 'structured_v2' | 'harness'
  - `tasks` Task[], required
    - `prompt` Message[], required
      - `role` 'system' | 'user' | 'assistant', required
      - `content` string, required
    - `answer` object, required
    - `split` 'train' | 'dev' | 'test'
    - `family` string, nullable
  - `states` string[]
  - `environment_id` string, uuid, nullable
  - `recording` object, nullable
  - `grader_id` string, uuid, nullable
  - `grader_revision` string, nullable

## Response `202`

Successful Response

- RlDatasetCheck
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `slug` string, required
  - `recipe` string, required
  - `environment_id` string, uuid, nullable, required
  - `tasks` integer, required
  - `state` string, required
  - `error` string, nullable, required
  - `dataset_version_id` string, uuid, nullable, required
  - `summary` object, nullable, required
  - `requested_by` string, required
  - `created_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required
  - `report` object[], nullable

## 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)
