---
title: "Upload locker-room media"
method: POST
path: "/api/upload/locker-media"
tags: ["User"]
---

# Upload locker-room media

`POST /api/upload/locker-media`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/upload/locker-media`
- Auth: HTTP bearer

Multipart media for locker-room posts (UGC terms gated). `file` is a JPEG/PNG/WebP/GIF image (≤8MB) or MP4/MOV/WebM video (≤40MB); optional `poster` is a client-supplied video thumbnail image. For videos without a decodable supplied poster the server extracts a real frame server-side; when extraction fails the solid placeholder PNG is stored instead — the upload still succeeds. `data.posterKind` (`supplied` | `extracted` | `placeholder`) reports video poster provenance and is present only when `type` is `video`; photo responses omit it. Provenance is also recorded server-side in the upload ledger and persisted on the media row at post create — clients never submit it.

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: Image (JPG/PNG/WebP/GIF, ≤8MB) or video (MP4/MOV/WebM, ≤40MB)
  - `poster` string, binary: Optional client-supplied video poster image (JPG/PNG/WebP/GIF)

## Response `200`

{ success, data: { url, type, thumbnailUrl, posterKind? } } — `posterKind` present only for `type: "video"`; extraction failure still returns 200 with `posterKind: "placeholder"`

- object
  - `success` boolean
  - `data` object
    - `url` string, required: Public blob URL of the uploaded media
    - `type` 'photo' | 'video', required
    - `thumbnailUrl` string, required: Poster/thumbnail blob URL (equals `url` for photos)
    - `posterKind` 'supplied' | 'extracted' | 'placeholder': Video poster provenance; omitted for photos

## Other responses

- `400`: Validation error (missing/invalid/oversized file)
- `401`: Authentication required
- `403`: UGC terms not accepted

## Changes

- **2026-11-18** `6de639c52609`: 1 breaking, 2 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `403`
- **2026-09-12** `c191eafc1801`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/upload/locker-media/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
