---
title: "Refresh Creator Rankings"
method: POST
path: "/admin/rankings/refresh"
tags: ["Admin"]
---

# Refresh Creator Rankings

`POST /admin/rankings/refresh`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/admin/rankings/refresh`
- Auth: none declared

Start a rebuild of one country board, or every supported market.

Returns as soon as the work is scheduled. A single board is a
synchronous Apify run that can take minutes, and the full sweep runs
them back to back — far longer than the serverless proxy in front of
this endpoint will hold a connection open. Waiting inline is what
made the admin panel's first attempt fail with a bare "Network
error" while the run itself was healthy. Poll
``GET /admin/rankings/status`` for progress.

Each board is replaced wholesale — a creator who fell off the
leaderboard has to disappear from it — but a fetch that comes back
empty leaves the existing board alone rather than blanking a live
page.

## Query parameters

- `country` string, nullable
- `window` string
- `limit` integer

## Headers

- `x-admin-secret` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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