ROroma
Items

Pre-signed slots for image bytes

Get pre-signed URLs to upload images DIRECTLY into Roma storage — the reliable alternative to passing third-party links in imageUrls (those must stay fetchable until the server downloads them; short-lived signed links often expire first). For each slot: HTTP PUT the raw image bytes to uploadUrl with the matching Content-Type header (valid ~2 hours), then pass its bucketPath as an imageUrls entry in create_items / update_items. Keep images at or under 10 MB (maxBytes). Up to 10 slots per call.

post/api/v1/uploads

Request

  • Base URL
    https://api.roma.app
  • URL
    https://api.roma.app/api/v1/uploads
  • Auth
    HTTP bearer

Request body

mimeType'image/png' | 'image/jpeg' | 'image/heic' | 'image/webp' required

The image type you will upload (all slots in one call share it).

countinteger

How many upload slots (default 1).

Response

Created; the body is the new item.

maxBytesnumber required
validForSecondsnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.