---
title: "Create a new judge"
method: POST
path: "/v1/observability/judges"
tags: ["beta.observability.judges"]
---

# Create a new judge

`POST /v1/observability/judges`

Create a new judge

## Request body

- CreateJudgeRequest
  - `name` string, required
  - `description` string, required
  - `model_name` string, required
  - `output` union, required
    - JudgeClassificationOutput
      - `type` 'CLASSIFICATION'
      - `options` JudgeClassificationOutputOption[], required
        - `value` string, required
        - `description` string, required
    - JudgeRegressionOutput
      - `type` 'REGRESSION'
      - `min` number
      - `min_description` string, required
      - `max` number
      - `max_description` string, required
  - `instructions` string, required
  - `tools` string[], required

## Response `201`

Successful Response

- Judge
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time, nullable, required
  - `owner_id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `name` string, required
  - `description` string, required
  - `model_name` string, required
  - `output` union, required
    - JudgeClassificationOutput
      - `type` 'CLASSIFICATION'
      - `options` JudgeClassificationOutputOption[], required
        - `value` string, required
        - `description` string, required
    - JudgeRegressionOutput
      - `type` 'REGRESSION'
      - `min` number
      - `min_description` string, required
      - `max` number
      - `max_description` string, required
  - `instructions` string, required
  - `tools` string[], required
  - `up_revision` string, uuid, nullable
  - `down_revision` string, uuid, nullable
  - `base_revision` string, uuid, nullable

## Other responses

- `400` — Bad Request - Invalid request parameters or data
- `404` — Not Found - Resource does not exist
- `408` — Request Timeout - Operation timed out
- `409` — Conflict - Resource conflict
- `422` — Unprocessable Entity - Validation error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)