Prepare upload
Prepare a direct media upload into a project or the Library. Returns a short-lived single-PUT instruction or multipart session. File bytes go directly to storage.
Authorizations
A workspace API key.
Headers
Required stable id for this logical write; reuse it after a timeout. Upload endpoints also require the same value in body.idempotencyKey.
1 - 255Body
Base file name only; directory separators and control characters are refused.
1 - 255Allowed video, audio, or image media type determined from the local file.
video/mp4, video/quicktime, video/webm, video/x-m4v, video/mpeg, image/jpeg, image/png, image/webp, image/gif, audio/mpeg, audio/mp4, audio/wav, audio/webm, audio/x-m4a, audio/flac Exact local file size in bytes; maximum 50 GiB.
x <= 53687091200Must exactly match the Idempotency-Key header.
1 - 255Project that owns the upload. Omit for a Library upload that belongs to no project; then omit it on every later call too.
1 - 200Lowercase SHA-256 of the complete local file when available.
^[a-fA-F0-9]{64}$Expired or failed upload authority to replace after the cockpit verifies the same project and file binding.
^aus_[a-f0-9]{48}$Library title; defaults to fileName.
1 - 200Primary output/source platform; defaults to youtube.
tiktok, instagram, youtube, reddit, x Optional tags stored with the asset.
20Recognized human or source-kind asset tag.
hook, demo, testimonial, problem, cta, trend, screen-recording, audio-recording, autosync Known media duration in seconds; omit when the client cannot determine it.
0 <= x <= 43200Upload lane preference; auto selects multipart for large files.
auto, single, multipart Stable id of the uploading device; Sigmora records its sync health.
1 - 128^[A-Za-z0-9._:-]+$Multipart part size the client can hold in memory, 5 to 64 MiB.
5242880 <= x <= 67108864Up to 50 sig.* storage metadata entries (for example sig.shootId).
File fingerprint: SHA-256 over the SHA-256 of each 8 MiB slice followed by the byte size. Recorded on the asset so the same file is understood once.
^sha256-8m:[a-f0-9]{64}$Response
Success.
Durable Sigmora upload-session id.
Stable asset id reserved for this upload.
Storage content id bound to the asset.
Selected byte-transfer lane.
single, multipart Short-lived direct-storage transfer instruction.