Media

Add media

With contentType and size (up to 4 GB), the answer says where to send the file: PUT each part, then call complete if there is one, and the media is ready. With url, Rizamo downloads the file and the media is ready in the answer. Media is yours until a post uses it, and then belongs to that post's profile (or to profileId at once): keys and people limited to some profiles reach their own media and their profiles'. Media not used by a post within 7 days is deleted.

post/media

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

urlstring uri

Import: a public http or https address. Rizamo downloads the file during this call; contentType and size are then ignored.

contentType'image/jpeg' | 'image/png' | 'image/webp' | 'video/mp4' | 'video/quicktime' | 'application/pdf'

Upload: the file's type, such as image/jpeg or video/mp4, with size.

sizeinteger

Upload: the file's bytes, up to 4 GB. With contentType.

altstring

Describes the image for people who cannot see it.

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

Changes

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