# Get message media

**GET** `/media/{mediaId}`

Returns an authorized, short-lived download URL for Flownally-hosted media.
Use `content.media.mediaId` from inbound messages, webhook payloads, WebSocket
events, or upload responses as `{mediaId}`. If media ingestion is still in
progress, the response has `ready: false` and no URL.

Authentication: bearerAuth
Required scopes: `conversation:read`
Allowed roles: `owner`, `admin`, `agent`
Authorization: Get an authorized download URL for message media.

## Parameters

- `mediaId` (path string, required) - Flownally media handle from `content.media.mediaId`.

## Responses

- `200`: Media download URL, when the object is ready.
- `default`: Error