---
title: "Upload Media"
method: POST
path: "/v1/native/media"
tags: ["native"]
---

# Upload Media

`POST /v1/native/media`

## Request

- Base URL: `https://api.mundane.market` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mundane.market/v1/native/media`
- Auth: none declared

Store one photo for a thread; the next message can carry it.

The paperclip in the console uploads here first and sends the id with the
message, so a slow upload never holds the text back and a failed one never
sends a message that promises a photo it does not have.

## Query parameters

- `thread` string, required
- `filename` string

## Headers

- `authorization` string

## Cookies

- `mundane_principal_session` string, nullable

## Response `201`

Successful Response

- MediaOut
  - `media_id` string, required
  - `filename` string, required
  - `content_type` string, required
  - `byte_size` integer, required

## Other responses

- `422`: Validation Error

---

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