Media

Get a presigned URL, PUT your file to it, then use the returned publicUrl in mediaUrls.

POST/media/upload-urlmedia:write

Presigned upload. Works for any size (incl. video) and is required for TikTok photos.

request bodyjson

{
  "filename": "slide.jpg",       // optional
  "contentType": "image/jpeg",   // optional
  "sizeBytes": 204800,           // optional
  "prefix": "posts"              // optional
}

responsejson

HTTP 201 — { "uploadUrl": "…", "publicUrl": "…" }

# then upload the bytes:
curl -T ./slide.jpg "<uploadUrl>" -H "Content-Type: image/jpeg"