issues

The open issue queue, worst first

The open issue queue, worst first: each issue with its severity, state, affected pages, what it costs to fix and the version to pass back when you act on it. Open means not verified_resolved, ignored or no_longer_checked; state: all lists every state, any other state only that one. Omit site for every site this key can see; pass it for one site. A row is a summary: read the issue's work order with issues_get before you change anything. staleness: not_seen_in_latest means the latest crawl did not see the issue; that is not a fix, and only the verifier resolves an issue. checked names the sample a count is of; effort.label says the fix in its unit (3 templates + 12 pages, 1 fix, 15 groups). With site, search gives the clicks Google sent the issue's pages, or why not; sort: clicks orders one site's queue by them (search:read and the plan). total is exact; pass page_info.next_cursor back as cursor for the next page. Next: issues_get for the issue you will fix.

get/v1/issues

Request

  • Base URL: https://frontshelf.io/api
  • URL: https://frontshelf.io/api/v1/issues
  • Auth: HTTP bearer

Query parameters

sitestring

Site ID (site_…), origin (https://example.com), or bare domain, resolved server-side; the response carries the canonical ID. Omit for every site this key can see.

state'open' | 'acknowledged' | 'ignored' | 'pending_fix' | 'awaiting_merge' | 'awaiting_deployment' | 'verification_queued' | 'verification_running' | 'verified_resolved' | 'verification_failed' | 'regression_detected' | 'needs_human_review' | 'no_longer_checked' | 'all'

open (default): every issue that is not verified_resolved, ignored or no_longer_checked, so acknowledged, awaiting_deployment, the verification states and the rest are in it. all: every state. Any other value: exactly that state. An issue's own state field can read open too: that is the narrower lifecycle state, a new issue nobody has acknowledged yet.

sort'priority' | 'clicks'

priority (default): worst first. clicks: one site's queue by the clicks Google gave each issue's pages (needs site, search:read and the plan).

limitinteger

Items per page (1 to 100).

cursorstring

The continuation from a previous page's page_info.next_cursor. Never construct one.

Response

The open issue queue, worst first

summarystring required

The answer in one or two sentences, with the numbers it rests on.

warningsstring[] required

What limits this answer (a cap, a read that was cut short). Empty when nothing does.

truncatedboolean required

True when more issues match than this page holds.

totalinteger required

How many issues match the state asked for, exactly; not the rows of this page.

Changes

No recorded changes to this operation across all 1 revision of this API.