Next free queue slot

GET

/queue/next

curl --request GET \
  --url https://postflow.biz.id/api/v1/queue/next \
  --header 'Authorization: Bearer <token>'

At least 10 minutes away and 30 minutes from any other post. 404 when there are no slots or all are taken for 8 weeks.

MCP tool: next_queue_slot.

Authorizations

• apiKey
• oauth

Parameters

Query Parameters

exclude

string

Ignore this post’s times (when moving it).

Responses

200

OK

Media typeapplication/json

object

at

required

The slot’s time.

string format: date-time

label

required

E.g. “Tue 09:00” in the workspace time zone

string

Example ^generated

{
  "at": "2026-04-15T12:00:00Z",
  "label": "example"
}

401

Missing, invalid, expired or deleted key or token.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

404

Not found in this workspace.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

More than 120 requests in a minute with this key.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL

message

required

A sentence you can show to a person.

string

details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}