API referenceUploads

Finish an image, video or audio upload

After the bytes of an image/video/audio upload are in storage (one PUT to upload_url, or every part), POST here.

Assembles a multipart upload, checks the stored file (its magic number must match the extension; size caps; the plan's storage) and files it in the media library through the ingest pipeline. Audio also becomes a music track (transcoded + tempo/beat-analysed; not for kind "sfx") and the response is ReceivedUploadResponse (track_id, asset_id, analysis). A refused file is deleted. Authorised by the signed token in the path. Idempotent.

POST
/uploads/{token}/complete

Path Parameters

token*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/uploads/string/complete"
{
  "data": {
    "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",
    "public_url": "http://example.com",
    "bytes": 0,
    "content_type": "string",
    "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
    "ingest": "queued",
    "next": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}