Boring Marketingdocs

Get Queue Item

Fetch a single action queue item by ID. Returns the bare item shape (not wrapped in a list envelope).

GEThttps://api.boringmarketing.com/brands/{brand_id}/queue/{queue_id}

Returns a single queue item by ID. Use this when you already have a queue_id (e.g. from a prior call to GET /brands/{id}/queue) and want to re-read just that one row without pulling the entire queue.

Unlike the list endpoint, this response is the bare queue item — not wrapped in a {brand_id, total, queue: [...]} envelope. Agents parsing both endpoints should branch on the shape.

Path parameters

brand_idstringrequired

The brand UUID.

queue_idstringrequired

The queue item ID — the id field on a queue row (not source_id). By convention this is a UUID, but the route does not validate the format; unknown IDs return 404.

Response

{
  "id": "qi-uuid-1",
  "kind": "opportunity",
  "source_id": "opp-uuid",
  "status": "pending",
  "rank": 1,
  "priority": 0.95,
  "item": {
    "play": "AI Marketing Tools Comparison Guide",
    "summary": "High-intent cluster, 12K volume, KD 34",
    "recommended_format": "comparison",
    "family": "Marketing Automation"
  },
  "created_at": "2026-04-08T12:00:00Z",
  "updated_at": "2026-04-08T12:00:00Z"
}

The item sub-shape is polymorphic on kind — same rules as the list endpoint:

kinditem shape
opportunity{ play, summary, recommended_format, family }
insight{ text, category, severity }

See Action Queue for full field-level documentation of the shared shape.

The id field on this response is what you pass as queue_item_id to POST /brands/{id}/brief. Do not pass source_id — that's the underlying opportunity or insight row, and the brief endpoint will 404.

Errors

StatusMeaning
401Missing or invalid X-API-Key header.
402Daily call budget exhausted (credits_exhausted). Raised by the tier middleware before the handler runs.
403The caller does not own this brand.
404Brand not found, OR queue item not found for this brand. The 404 is returned even if the queue item exists but belongs to a different brand — cross-brand lookups are never leaked.
422brand_id is not a valid UUID.

Example

curl -H "X-API-Key: $BM_API_KEY" \
  https://api.boringmarketing.com/brands/$BRAND_ID/queue/$QUEUE_ID