Skip to main content
POST
Get presigned media URL

Authorizations

apikey
string
header
required

Your Pilot Status API key (ps_...). Evolution GO also accepts Authorization: Bearer <key>.

Path Parameters

instance
string
required

The number's display name in the Pilot Status dashboard.

Body

application/json
id
string
required

Media record identifier (numeric string).

Example:

"12345"

expiry
string

Lifetime of the presigned URL, in seconds (numeric string, e.g. "3600").

Example:

"3600"

Response

Success — provider-native response body.

A single media record plus a freshly generated presigned URL for downloading the object from S3/MinIO.

mediaUrl
string

Presigned URL to download the stored media object (valid for the requested expiry, in seconds).

id
string

Media record id (cuid).

fileName
string

Object key / path of the file stored in the S3/MinIO bucket.

type
string

Media category (e.g. image, video, audio, document, sticker).

mimetype
string

MIME type of the stored file.

createdAt
string<date-time>

Date the media record was created.

Message
object

The Message this media belongs to.