rizamodocs
Media

Ask a person for files

POST
/uploads

Returns a page to give a person. They add images or videos there, no sign-in needed, and send them. Follow status with Get an upload request; its media are ready to use on a post. The page works for 24 hours.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the web app, under Developers. It starts with rz_live_.

Header Parameters

Idempotency-Key?string

1 to 255 printable characters, new for each request (a UUID); the body up to 1 MB. For 24 hours a repeat with the same key, path and body gets the first answer, with Idempotent-Replayed: true, instead of running again; 5xx, 409 and 429 answers are not kept. Errors, Retries, has the rest.

Length1 <= length <= 255

Request Body

application/json
  1. body
note?string

What you need, shown on the page: "The photos from Saturday's tasting".

Lengthlength <= 500
Default""
maxFiles?integer

How many files the person may add, up to 20: 10 when left out.

Range1 <= value <= 20
Default10
profileId?string

Optional: a profile you reach, which the media joins at once. Left out, the media is yours (the person, key or agent that added it) until a post uses it, and then joins that post's profile.

Lengthlength <= 100

Response Body

OK

application/json
  1. response
id*string
status*string

done: the person sent their files. expired: 24 hours went by.

Value in"open""done""expired"
note*string
maxFiles*integer
Range-9007199254740991 <= value <= 9007199254740991
media*array<>

The files the person added so far, ready to put on a post.

profileId*|

The profile the files join at once. Null when the request named none: the files are then the asker's until a post uses them.

url*|

The page to give the person. Only in the answer that creates the request.

expiresAt*string
Formatdate-time
Example Request
curl -X POST 'https://api.rizamo.com/v1/uploads' \  -H 'Idempotency-Key: 4b9e7c1a-2f3d-4e8a-9c6b-1d2e3f4a5b6c' \  -H 'Content-Type: application/json' \  -d '{  "note": "The photos from Saturday'\''s tasting",  "maxFiles": 10,  "profileId": "prof_01m40k9k80fxd8cvng8derm7g9"}'
Example Response
{  "id": "upr_01m4abq540fy78hvv8x8xs62tm",  "status": "open",  "note": "The photos from Saturday's tasting",  "maxFiles": 10,  "media": [],  "profileId": "prof_01m40k9k80fxd8cvng8derm7g9",  "url": "https://app.rizamo.com/upload/team_01m3z8q2e0f5w1bq6h0yvj0x2a/u7Kq2WmZp9Xr4TbL",  "expiresAt": "2026-11-05T10:12:31.000Z"}

Get media GET

One image or video: `ready` once its file arrived, with its size, dimensions and length, and a link to view it that works for a few hours.

Get an upload request GET

Whether the person sent their files: `done` once they did, with `media` ready to put on a post. Its page's address is only in the answer that created it.