---
title: "Upload Entity Media"
method: POST
path: "/api/v1/entities/{entity_id}/media"
tags: ["Entities"]
---

# Upload Entity Media

`POST /api/v1/entities/{entity_id}/media`

## 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/entities/{entity_id}/media`
- Auth: none declared

Upload media for an entity — image, audio, or video.

The ranking's media_type determines what's accepted.
- Image: JPEG/PNG/WebP/GIF → center-cropped 400x400 JPEG
- Audio: MP3/WAV/OGG/M4A → saved as-is with waveform thumbnail (max 60s)
- Video: MP4/WebM/MOV → saved as-is with frame thumbnail (max 15s)

Returns media_url + thumbnail + metadata.

## Path parameters

- `entity_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)