---
title: "Update Ranking"
method: PUT
path: "/api/v1/rankings/{ranking_id}"
tags: ["Rankings"]
---

# Update Ranking

`PUT /api/v1/rankings/{ranking_id}`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/rankings/{ranking_id}`
- Auth: API key in header `X-API-Key`

Update a ranking.

## Path parameters

- `ranking_id` string, required

## Request body

- RankingUpdate
  - `name` string, nullable
  - `description` string, nullable
  - `is_public` boolean, nullable
  - `visibility` string, nullable
  - `category` string, nullable
  - `comparison_prompt` string, nullable
  - `ends_at` string, date-time, nullable
  - `goal` string, nullable
  - `min_raters_per_pair` integer, nullable
  - `qualification_required` boolean, nullable
  - `qualification_pass_threshold` number, nullable
  - `constitution` unknown[], nullable
    - unknown
  - `objectives` unknown[], nullable
    - unknown
  - `judge_mode` string, nullable
  - `default_judge_model` string, nullable
  - `vote_weighting` string, nullable
  - `settings` object, nullable

## Response `200`

Successful Response

- RankingResponse
  - `id` string, required
  - `slug` string, nullable
  - `name` string, required
  - `description` string, nullable, required
  - `is_public` boolean, required
  - `visibility` string
  - `tenant_id` string, nullable
  - `category` string, nullable, required
  - `owner_id` string, required
  - `entity_count` integer, required
  - `vote_count` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `user_role` string, nullable
  - `media_type` string, nullable
  - `comparison_prompt` string
  - `vote_type` string
  - `ends_at` string, date-time, nullable
  - `goal` string, nullable
  - `min_raters_per_pair` integer
  - `qualification_required` boolean
  - `qualification_pass_threshold` number
  - `judge_mode` string
  - `default_judge_model` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aimrank/apis/aimrank-api.md) · [All operations](https://skmtc.dev/aimrank/apis/aimrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimrank/apis/aimrank-api/revisions/3574d0aff459?raw)