Approval Queue

Read-only summary views over the posts currently moving through the approval workflow. For the actions that submit, approve, and reject individual posts, see Approval Workflows.

Base URL


https://api.voxburst.io/v1/approval-queue

Authentication: Requires the queues:read scope. This is a read-only group — there is no queues:write scope, and any non-GET request returns 403.

Get Pending Approval Count

GET /v1/approval-queue/pending-count

Single aggregate count of approval steps currently PENDING across the workspace. Designed for a sidebar/badge count — a single query, no per-post fetches.


curl https://api.voxburst.io/v1/approval-queue/pending-count \
  -H "Authorization: Bearer vb_live_xxxxxxxxxxxxx"

Response


{ "count": 4 }

List Approval Queue Items

GET /v1/approval-queue/items

Returns every post in the workspace that has an active (non-empty) approval workflow, including fully approved and rejected ones — not just pending. Queried from the same underlying data as pending-count, so the two always stay in sync.


curl https://api.voxburst.io/v1/approval-queue/items \
  -H "Authorization: Bearer vb_live_xxxxxxxxxxxxx"

Response


{
  "items": [
    {
      "post": {
        "id": "post_abc123",
        "content": "Draft copy pending review",
        "status": "draft",
        "contentType": "TEXT",
        "scheduledFor": null,
        "createdAt": "2026-08-29T00:00:00.000Z",
        "updatedAt": "2026-08-29T00:00:00.000Z",
        "platforms": [
          {
            "platform": "twitter",
            "accountId": "acc_abc123",
            "accountName": "@voxburst",
            "status": "pending"
          }
        ]
      },
      "workflowName": "Default Approval",
      "overallStatus": "IN_PROGRESS",
      "currentStep": 1,
      "steps": [
        {
          "id": "step_abc123",
          "stepOrder": 1,
          "role": "Editor",
          "status": "PENDING",
          "approverId": null,
          "comment": null,
          "decidedAt": null,
          "createdAt": "2026-08-29T00:00:00.000Z"
        }
      ]
    }
  ]
}

Response Fields

Field	Type	Description
`overallStatus`	string	`"IN_PROGRESS"`, `"FULLY_APPROVED"`, or `"REJECTED"` — derived from the step statuses
`currentStep`	number \| null	`stepOrder` of the first still-`PENDING` step, or `null` if none pending
`workflowName`	string \| undefined	Name of the approval workflow this post is running through
`steps[].role`	string	The role assigned to this step in the workflow definition