Media

Ask a person for files

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.

post/uploads

Request

  • Base URL
    https://api.rizamo.com/v1
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

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.

Request body

notestring

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

maxFilesinteger

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

profileIdstring

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.

Response

OK

idstring required
status'open' | 'done' | 'expired' required

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

notestring required
maxFilesinteger required
profileIdstring nullable required

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.

urlstring nullable required

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

expiresAtstring date-time required

Changes

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