---
title: "Update Leaderboard"
method: PUT
path: "/v1/leaderboards/{leaderboard_id}"
tags: ["Leaderboards"]
---

# Update Leaderboard

`PUT /v1/leaderboards/{leaderboard_id}`

## Request

- Base URL: `https://api.aghanim.com/s2s`
- URL: `https://api.aghanim.com/s2s/v1/leaderboards/{leaderboard_id}`
- Auth: HTTP bearer

Updates a leaderboard.

## Path parameters

- `leaderboard_id` string, required

## Request body

- LeaderboardUpdate
  - `start_at` integer
  - `end_at` integer
  - `name` string: The name of the leaderboard.
  - `description` string: The description of the leaderboard.
  - `visibility` 'general' | 'personal'

## Response `200`

Successful Response

- LeaderboardRead
  - `name` string, required: The name of the leaderboard.
  - `description` string, required: The description of the leaderboard.
  - `visibility` 'general' | 'personal'
  - `start_at` integer: The start date of the leaderboard in Unix timestamp.If set, the leaderboard will only be visible in game-hub after this date.
  - `end_at` integer: The end date of the leaderboard in Unix timestamp.If set, the leaderboard will only be visible in game-hub before this date.
  - `id` string, required: The unique identifier of the leaderboard.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-05** `0ef278347679`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-18** `fb9750c99d0a`: 1 warning
  - for the `path` request parameter `leaderboard_id`, the maxLength was set to `32`

[Operation history](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/changes/v1/leaderboards/:leaderboard_id/put.md)

---

[API](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api.md) - [All operations](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/revisions/b084a5d2cd02?raw)