rizamodocs
Profiles

Get a profile's queue

GET
/profiles/{id}/queue

Its posting times, read in its time zone; the next count times free for at least one of its accounts, with which ones (none of them has a post at that minute, scheduled or queued, and none would pass its network's daily cap); and its queued posts still to go out.

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

Query Parameters

count?integer

How many free times to list.

Range1 <= value <= 50
Default10

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 GET 'https://api.rizamo.com/v1/profiles/prof_01m40k9k80fxd8cvng8derm7g9/queue?count=3'
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"      ]    }  ]}

Delete a profile DELETE

For good: what is in it cannot be restored. Its posts go, deleted ones included, with their history and preview links (posts already published stay on the networks), and so do its posting times, its upload requests and connect links, its other events, and its media that no post of another profile uses. Its short links stay and keep working, with no profile. People and invitations limited to some profiles, API keys, agents and webhook endpoints lose it from their profiles: a key or agent that reached only this profile is revoked, and an endpoint that took only its events is disabled (`disabledReason` `profile_deleted`). Refused (409) while it has accounts (move each to another profile, or remove it, first), when it is the team's only profile, while one of its posts is going out, and while a person or an open invitation reaches no other profile, naming them. Only an owner deletes a profile, signed in as themselves within the last 15 minutes (with their session, as the web app does), or an API key an owner let remove accounts and delete profiles when making it (Developers in the web app). Other API keys and agents are refused (403), and a key reaches only its own profiles.

Set a profile's queue PUT

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.