Media¶

1 endpoint. Paths are relative to https://rmhstudios.com.

Endpoint	Scope	Summary
`POST /api/v1/images`	`write:media`	Upload an image

Reference¶

`POST /api/v1/images`¶

Upload one image (multipart/form-data, field image, max 5 MB) and receive an opaque media_id to attach to a post via media_ids. Unattached media expires ~24h after upload.

Scope: write:media · Success: 201 · Operation id: uploadImage

Request body (multipart/form-data)

Field	Type	Required	Description
`image`	`file`	yes	png/jpg/webp/gif, max 5 MB.

Example response (201)

{
  "id": "media_abc",
  "type": "image",
  "expires_at": "2026-07-01T10:00:00.000Z"
}