Complete upload

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>",
    "url": "<string>",
    "mimeType": "<string>",
    "fileSize": 123,
    "createdAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

POST

uploads

complete

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>",
    "url": "<string>",
    "mimeType": "<string>",
    "fileSize": 123,
    "createdAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

Final step of the signed-URL flow: after PUTting the file bytes to the signed uploadUrl, call this with the blobName from the same response to record the file as an asset in your media library. The server verifies the object actually exists in storage (you get a 400 if the PUT didn’t happen) and reads its size and MIME type from storage metadata. blobName must come from your own signed-URL response — blobs outside your upload prefix are rejected with 403.

Response

Same shape as POST /uploads:

{
  "success": true,
  "data": {
    "id": "cm456def",
    "name": "big-video.mp4",
    "url": "https://.../uploads/usr_123/2026-08-04T10-00-00-000Z-big-video.mp4",
    "mimeType": "video/mp4",
    "type": "VIDEO",
    "fileSize": 209715200,
    "createdAt": "2026-08-04T10:00:00.000Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

blobName

string

required

fileName

string

Response

Registered asset

success

boolean

data

object

Show child attributes

API documentation

CLI

User

Accounts

Posts

Generation status

Video generator

Image generator

Music generator

Voiceover

AI influencer

Thumbnail generator

Clipping

Uploads

Complete upload

Response

Authorizations

Body

Response

​Response

Authorizations

Body

Response

Response