Skip to content
Linq Copy agent prompt

Media

Upload durable media bytes before addressing them from a media part.

Upload media
POST/v1/media
ModelsExpand Collapse
Upload object { byte_size, kind, mime_type, 2 more }

A durable upload that can be reused by outbound media parts. No fixed beta expiry is promised.

byte_size: number

Exact byte count stored.

formatint64
kind: "image" or "video" or "audio" or 2 more

The media kind chosen at upload. A send using this handle must use the same kind.

One of the following:
"image"
"video"
"audio"
"document"
"sticker"
mime_type: string

The normalized media type stored with the bytes.

sha256: string

Lowercase hexadecimal SHA-256 over the exact stored bytes.

upload_ref: string

Our reusable handle. It always begins upload. and is supplied as a media part’s upload_ref. It has no fixed beta expiry or scheduled pruning, but is not permanent and may be removed by account deletion or offboarding.