---
title: "Updates a leaderboard using patch semantics."
method: PATCH
path: "/leaderboard/{leaderboardId}"
tags: ["Leaderboard"]
---

# Updates a leaderboard using patch semantics.

`PATCH /leaderboard/{leaderboardId}`

## Path parameters

- `leaderboardId` string, required

## Request body

- UpdateLeaderboardEndpointInput
  - `name` string — The new name of the leaderboard.
  - `responseBudget` integer — The response budget collected when onboarding a new participant.
  - `minResponses` integer — The minimum responses collected per matchup.
  - `priority` integer, nullable — Priority override applied to every run's job. Admin-only. Pass null to clear the override and fall back to the default leaderboard priority.
  - `weight` number, double — Multiplier applied to every match result of this leaderboard when it contributes to the parent benchmark's overall / combined scoreboards. Unbounded; negative and zero values are accepted.
  - `scoreShift` number, double — Additive offset applied to displayed scores on this leaderboard's per-leaderboard scoreboard.
  - `scoreScale` number, double — Multiplicative factor applied to displayed scores (relative to the Bradley-Terry center) on this leaderboard's per-leaderboard scoreboard. Must be strictly positive.
  - `isHidden` boolean — Whether the leaderboard is hidden from non-admins in listings and reads. Admin-only.
  - `isExcludedFromOverall` boolean — Whether the leaderboard is excluded from its benchmark's overall / combined scoreboard. When set, the leaderboard becomes an owner-only private experiment: its results do not contribute to the overall and it is visible only to its owner and admins.
  - `voteAggregation` 'AllVotes' | 'MajorityVote'
  - `includedTags` string[] — Prompt tag values to restrict the leaderboard's matchups to. Only prompts carrying at least one of these tags are used; an empty list means no restriction.
  - `excludedTags` string[] — Prompt tag values the leaderboard never creates matchups for. Takes precedence over includedTags: a prompt carrying an excluded tag is skipped even when one of its other tags is included.

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/versions/e42ec51c7b88/schema)