PostZen
Queues

Preview upcoming queue slots

GET
/v1/queue/preview

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.

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.

count?integer

How many upcoming slots to return.

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/preview?profileId=string"
{  "profileId": "string",  "count": 0,  "slots": [    "2019-08-24T14:15:22Z"  ]}
{  "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"}

Get the next queue slot GET

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.

Get post analytics GET

> **Coming soon** — Analytics endpoints are being rolled out and may return empty data until the rollout completes. Returns one post when `postId` is supplied. Otherwise returns a paginated analytics list with aggregate overview metrics.