Skip to main content
POST
Create Upload URL

Authorizations

x-api-key
string
header
required

Body

application/json

Request to create a presigned upload URL.

filename
string
required

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

Response

200 - application/json

Successful Response

Response with presigned upload URL and beeble:// URI.

id
string
required

Upload ID (upload_...)

upload_url
string
required

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

beeble_uri
string
required

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