Skip to main content
POST
Register a file upload

Authorizations

X-Axilio-Api-Key
string
header
required

Customer API key (axl_ prefix).

Body

application/json

Registers an upload and requests a presigned PUT URL.

filename
string
required

Display name for the file (also its name on the phone).

Required string length: 1 - 255
mime_type
string
required

MIME type of the upload; must be an allowed image or video type.

Minimum string length: 1
size_bytes
integer<int64>
required

Exact size of the upload in bytes, up to 100 MiB (the phone-delivery ceiling); the presigned URL pins it.

Required range: 1 <= x <= 104857600

Response

Created

The registered file and its presigned upload URL.

file
object
required

The registered library entry.

upload_expires_in_seconds
integer<int64>
required

How long the upload URL stays valid.

upload_url
string
required

Presigned S3 PUT URL. PUT the raw file bytes to it with the declared Content-Type and Content-Length headers.