rizamodocs
Media

Get an upload request

GET
/uploads/{id}

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.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

id*string

The upload request's id (upr_).

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 GET 'https://api.rizamo.com/v1/uploads/upr_01m4abq540fy78hvv8x8xs62tm'
Example Response
{  "id": "upr_01m4abq540fy78hvv8x8xs62tm",  "status": "done",  "note": "The photos from Saturday's tasting",  "maxFiles": 10,  "media": [    {      "id": "med_01m48vn2c0emgvm8bkwtj1hayp",      "type": "image",      "url": "https://media.rizamo.com/media/med_01m48vn2c0emgvm8bkwtj1hayp.jpg?exp=1762437600&sig=b3Jp1Wq0kz8fLx2mQe7Rt5uYc9NvH4aD6sGj3hKl0Po",      "alt": "A flat white and a pastel de nata on the counter by the window",      "status": "ready",      "contentType": "image/jpeg",      "size": 842113,      "width": 1080,      "height": 1350,      "duration": null,      "profileId": "prof_01m40k9k80fxd8cvng8derm7g9"    }  ],  "profileId": "prof_01m40k9k80fxd8cvng8derm7g9",  "url": null,  "expiresAt": "2026-11-05T10:12:31.000Z"}