---
title: "Create Grader"
method: POST
path: "/llm/graders"
tags: ["llm"]
---

# Create Grader

`POST /llm/graders`

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

## Request body

- GraderIn
  - `workspace_id` string, uuid, required
  - `name` string, required
  - `definition` object, required
  - `input_schema` object, required
  - `required_checks` string[], nullable
  - `limits` object, nullable
  - `determinism` 'deterministic' | 'nondeterministic', nullable
  - `judge_task_id` string, uuid, nullable
  - `credential` string, password, nullable

## Response `201`

Successful Response

- Grader
  - `id` string, uuid, required
  - `grader_id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `name` string, required
  - `revision_sha256` string, required
  - `document` object, required
  - `remote` string[], required
  - `credential` boolean, required
  - `created_by` string, required
  - `created_at` string, date-time, 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)