Skip to main content
POST
Upload a file

Authorizations

x-bigco-hmac-sha256
string
header
required

Base64-encoded HMAC-SHA256 signature of the request. Every request must also include the x-bigco-hmac-username and x-date headers, and POST/PUT requests must include x-digest. See the Authentication guide for the full signing procedure.

Body

multipart/form-data
file
file
required

The binary file to upload.

Response

The uploaded file record.

id
string<uuid>
required

The unique ID of the uploaded file. Reference this in media_item_uuids.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

file_name
string
required
Example:

"my_image.jpeg"

uploaded_at
string<date-time>
required

UTC timestamp when the file was uploaded.

Example:

"2024-05-15T10:29:50Z"

mime_type
string | null
Example:

"image/jpeg"