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 5GB.

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 5GB.

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