rizamodocs
Profiles

Set a profile's queue

PUT
/profiles/{id}/queue

Replaces the profile's posting times with these, the whole week in one call; an empty list empties it. At most 24 a day, each once. Each is a local time in the profile's time zone, the same clock time all year. Posts already queued keep their times; only new ones take the new week.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

id*string

The profile's id (prof_).

Lengthlength <= 100

Request Body

application/json
  1. body
slots*array<>

The whole week, each time a weekday and a local time, at most 24 a day. An empty list empties the queue.

Itemsitems <= 168

Response Body

OK

application/json
  1. response
profileId*string
timeZone*string

The profile's time zone, which the slots are read in.

slots*array<>

Its posting times, Monday first, each day's in order.

next*array<>

The next posting times free for at least one of the profile's accounts, to show what is open. Never copy one into scheduledAt to take it: two callers would take the same one. Create the post with queue: true instead.

posts?array<>

The queued posts still to go out, soonest first, the next 100 at most, with their accounts (Get a post has the rest). Left out for a key or agent without posts:read: the queue's own read scope is accounts:read.

Example Request
curl -X PUT 'https://api.rizamo.com/v1/profiles/prof_01m40k9k80fxd8cvng8derm7g9/queue' \  -H 'Content-Type: application/json' \  -d '{  "slots": [    {      "weekday": "mon",      "time": "09:00"    },    {      "weekday": "wed",      "time": "12:30"    },    {      "weekday": "fri",      "time": "18:00"    }  ]}'
Example Response
{  "profileId": "prof_01m40k9k80fxd8cvng8derm7g9",  "timeZone": "Europe/Lisbon",  "slots": [    {      "weekday": "mon",      "time": "09:00"    },    {      "weekday": "wed",      "time": "12:30"    },    {      "weekday": "fri",      "time": "18:00"    }  ],  "next": [    {      "at": "2026-11-09T09:00:00.000Z",      "accountIds": [        "acc_01m423bp00fz39kp5pc7m42tsw",        "acc_01m42vcqc0e15apwrdjth3v2q5",        "acc_01m44bet40enpr62nh6w01e67r"      ]    },    {      "at": "2026-11-11T12:30:00.000Z",      "accountIds": [        "acc_01m423bp00fz39kp5pc7m42tsw",        "acc_01m42vcqc0e15apwrdjth3v2q5",        "acc_01m44bet40enpr62nh6w01e67r"      ]    },    {      "at": "2026-11-13T18:00:00.000Z",      "accountIds": [        "acc_01m423bp00fz39kp5pc7m42tsw",        "acc_01m42vcqc0e15apwrdjth3v2q5"      ]    }  ],  "posts": [    {      "id": "post_01m483m100e3pbp1zd7sm1b7hf",      "scheduledAt": "2026-11-13T18:00:00.000Z",      "accountIds": [        "acc_01m44bet40enpr62nh6w01e67r"      ]    }  ]}