---
title: "Upload Ranking Thumbnail"
method: POST
path: "/api/v1/rankings/{ranking_id}/thumbnail"
tags: ["Rankings"]
---

# Upload Ranking Thumbnail

`POST /api/v1/rankings/{ranking_id}/thumbnail`

## 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}/thumbnail`
- Auth: none declared

Upload a thumbnail image for a ranking.

Saves to static/thumbnails/{ranking_id}.{ext} and sets ranking.image_url.
Returned URL works immediately in OG cards and share previews.

## Path parameters

- `ranking_id` string, required

## Response `200`

Successful Response

- unknown

## 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)