uploads

Create Upload URL

Create a presigned upload URL for a media file.

post/v1/uploads

Request body

filenamestring required

Filename with extension (3-255 chars). Accepted: .mp4, .mov, .png, .jpg, .jpeg, .webp

Successful Response

idstring required

Upload ID (upload_...)

upload_urlstring required

Presigned PUT URL for uploading your file. Expires after 1 hour.

beeble_uristring required

beeble:// URI to reference this file in SwitchX generation calls (source_uri, reference_image_uri, or alpha_uri).