Skip to main content
POST
Create Upload URL
Use the same API key and internal team context for uploads and product jobs. See Uploads for the complete upload flow.

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, .mp3, .wav

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 a product's supported media input. SwitchX accepts image/video sources, references and alpha; models supporting audio references also accept uploaded MP3/WAV files.