Content queue

list_queue_tickets

The content queue's tasks with their status, impact and priority.

readReads only. Annotated read-only, so a client can call it without asking.

Plan: Grow and above
Rate cost: 1 unit
REST: GET /projects/{project_id}/queue

Try asking

“What's open in the content queue, highest priority first?”

list_queue_tickets

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_queue_tickets",
    "arguments": {
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "open"
    }
  }
}

structuredContent

{
  "content": [
    {
      "type": "text",
      "text": "…the same JSON, as text…"
    }
  ],
  "structuredContent": {
    "tickets": [
      {
        "id": "c1d2e3f4-5a6b-47c8-99d0-1e2f3a4b5c6d",
        "title": "Comparison page — \"best invoicing software for freelancers in India\"",
        "description": "Fixes \"best invoicing software for freelancers in India\" — 1 of 3 questions this draft covers.",
        "type": "comparison",
        "scope": "onsite",
        "impact": "high",
        "priority": 74,
        "status": "open",
        "prompt_ref": 12,
        "gap_prompt_id": "0e9a7c55-2b3d-4c1e-8f6a-9d0b1c2e3f4a",
        "asset_id": "d4e5f6a7-8b9c-40d1-92e3-4f5a6b7c8d9e",
        "assignee_name": null,
        "draft_content": null
      }
    ],
    "page": {
      "page": 1,
      "page_size": 50,
      "total": 6
    }
  },
  "isError": false
}

Arguments

Passed as the tool call's arguments.

project_idstringrequired

The project to read, from list_projects.

statusenum<string>

Keep only tasks with this status.

Values:openin_progressresolveddismissed

scopeenum<string>

Your site, or the wider web.

Values:onsiteoffsite

pageintegerdefault 1

Page number, from 1.

page_sizeintegerdefault 50

Rows per page, up to 100.

Result

The same object as List queue tasks, returned as structured output.

ticketsobject[]

Tasks, highest priority first.

+Show child attributes

idstring

Task id.

titlestring

What to do.

descriptionstringnullable

The detail behind it.

typestring

The kind of work, usually the page type — e.g. comparison, pricing, offsite, entity.

scopestring

Your site, or somebody else's.

Values:onsiteoffsite

impactstring

Size of the prize.

Values:highmediumlow

priorityinteger

0–100, higher first.

statusstring

Where it stands.

Values:openin_progressresolveddismissed

prompt_refintegernullable

The prompt's short number, when it's about one prompt.

gap_prompt_idstringnullable

The prompt whose gap it came from.

asset_idstringnullable

The content opportunity behind it.

assignee_namestringnullable

Who it's assigned to, by display name.

draft_contentstringnullable

The draft attached to it, when there is one.

pageobject

Where these rows sit in the full list.

+Show child attributes

pageinteger

This page's number, from 1.

page_sizeinteger

Rows per page.

totalinteger

Rows across every page.

Errors

404 not_found	The project or item doesn't exist in this workspace. A project from another workspace also returns 404, never 403.
422 invalid_request	A parameter or body field is missing or has the wrong type or value. The message names the field. Also returned when a write would pass the plan's prompt limit.
401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.

Failures arrive as a tool error — isError: true with code: message as text. See Using the tools.