Skip to main content
POST
Allocate an upload version and backend signed PUT slots

Authorizations

Authorization
string
header
required

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

Body

application/json
readable
UploadFileSpec · object
required

The one readable source (pdf/docx/pptx/image)

org_id
integer

Required for system tokens; customer organization comes from authentication and overrides this value.

asset_id
string<uuid> | null

Existing asset to add a version to. Absent mints a new asset.

originals
UploadFileSpec · object[]

Design originals (.ai/.psd/.indd). Archived as-is; no derivatives are produced.

Maximum array length: 10
callback_url
string<uri> | null

Per-stage webhook target. Polling status/latest.json is the fallback.

Required string length: 1 - 2083

Response

Successful Response

asset_id
string<uuid>
required
version
integer
required
folder
string
required

Bucket prefix holding this version

status_url
string
required

URL of status/latest.json for this version

uploads
UploadSlot · object[]
required