---
title: "Set/clear the org-level llm_judge model default"
method: PUT
path: "/v1/policies/judge-model"
tags: ["policies"]
---

# Set/clear the org-level llm_judge model default

`PUT /v1/policies/judge-model`

## Request body

- OrgPolicyJudgeModelUpdate — Set or clear the org-level ``llm_judge`` model default. ``model_settings=null`` clears the override (back to the code role default). A non-null entry must reference a model in ``MODEL_REGISTRY`` (422 otherwise); since the catalog == registry, anything the UI dropdown offers passes. The ``ModelChainEntry`` shape also validates the config knobs at the boundary.
  - `model_settings` ModelChainEntry
    - `model` string, required
    - `config` ModelConfig
      - `temperature` number, nullable
      - `max_tokens` integer, nullable
      - `top_p` number, nullable
      - `stop_sequences` string[], nullable
      - `reasoning_effort` 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
      - `request_timeout_ms` integer, nullable
      - `thinking_budget` integer, nullable

## Response `200`

Successful Response

- OrgPolicyJudgeModelResponse — The org-level default model for ``llm_judge`` policy checks. ``model_settings`` is the org's chosen ``ModelChainEntry`` (``{model, config}``), or ``null`` when unset — in which case the runtime falls back to the code role default (``gpt-5.4-mini`` / effort ``low``). The UI renders that fallback label from the model catalog's ``policy_judge`` role default, so this response carries ONLY the override.
  - `model_settings` ModelChainEntry
    - `model` string, required
    - `config` ModelConfig
      - `temperature` number, nullable
      - `max_tokens` integer, nullable
      - `top_p` number, nullable
      - `stop_sequences` string[], nullable
      - `reasoning_effort` 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
      - `request_timeout_ms` integer, nullable
      - `thinking_budget` integer, nullable

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/revisions/5a5597ebb2d6/schema)