create upload url | sync. labs

Request a presigned URL to upload a local file. PUT the file bytes to the returned uploadUrl with the same Content-Type, then register the file as an asset via POST /v2/assets using the returned url. Single uploads are capped at 5 GiB (5,368,709,120 bytes).

Authentification

x-api-keystring

Authentification par clé API via en-tête

Requête

This endpoint expects an object.

fileNamestringRequis

The name of the file to upload.

contentTypestringRequis

The MIME content type of the file (e.g. video/mp4).

sizeintegerRequis

The size of the file in bytes. Single uploads are capped at 5 GiB (5,368,709,120 bytes).

Réponse

Presigned upload URL created successfully

uploadUrlstring

The presigned S3 URL to PUT the file bytes to (with the same Content-Type).

urlstring

The final public URL of the file. Register it as an asset via POST /v2/assets once the upload completes.

expiresIninteger

Seconds until the presigned uploadUrl expires.

Erreurs

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error