PostZen
Queues

Get the next queue slot

GET
/v1/queue/next-slot

Returns the next free instant the queue would hand out. This is a preview only — the slot is not reserved. Create queued posts with queuedFromProfile rather than passing this value back as scheduledFor, or a concurrent create can take the slot first.

Authorization

bearerAuth
AuthorizationBearer <token>

PostZen API key.

In: header

Query Parameters

profileId*string

Profile that owns the queue.

queueId?string

Specific queue. Defaults to the profile's default queue.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/queue/next-slot?profileId=string"
{  "profileId": "string",  "nextSlot": "2019-08-24T14:15:22Z",  "timezone": "string",  "queueId": "string",  "queueName": "string"}
{  "error": "JSON body is required"}
{  "error": "Unauthorized"}
{  "error": "API key requires read_write permission"}
{  "error": "Not found"}
{  "error": "string"}
{  "error": "rate_limited",  "retryAfter": 30}
{  "error": "Failed to create post"}

Delete a queue DELETE

Deletes the queue named by `queueId`, or every queue on the profile when `queueId` is omitted. Posts already placed by the queue keep their scheduled times; only the queue link is removed. Deleting the default queue promotes the profile's oldest remaining queue. This endpoint requires a read-write API key.

Preview upcoming queue slots GET

Returns the next `count` instants the queue would hand out, in ascending order. Occupied slots are skipped, so the preview matches what the next posts would actually receive. Previewing reserves nothing.