Skip to content

Merge backstop sweep (GET) — cronmergebackstopget

GET
/cron/merge-backstop
curl --request GET \
--url 'https://example.com/api/cron/merge-backstop?dry_run=1&catch_up=1&pages=1'

Restored by HO-8020. Runs the merged-role repair, sweepUnmergedTickets (open un-merged tickets re-classified against recent push events, keyset-paged on updated_at) and sweepRecentGithubPrs (recently merged PRs that reference an HO ticket without a closing keyword). Query params: dry_run=1 classifies without writing, catch_up=1 widens the pass for a backlog drain, before=<ISO> is the paging cursor echoed back as nextCursor, pages=<1..2> follows that cursor in-process for up to that many ticket-sweep pages under one sweep deadline (HO-18165). Protected by CRON_SECRET via the x-cron-secret header only (no token query parameter).

dry_run
string
Allowed values: 1

Classify and report without writing any merge-close.

catch_up
string
Allowed values: 1

Widen the pass (200 tickets, 30 pushes per project, 7-day PR lookback) for a backlog drain.

before
string format: date-time

Keyset cursor — only tickets with updated_at strictly before this timestamp; take it from a previous response’s nextCursor.

pages
integer
default: 1 >= 1 <= 2

Ticket-sweep pages to run in this request (HO-18165). Each page after the first continues from the previous page’s nextCursor and runs only the ticket sweep; all pages share one sweep deadline. The response reports the pages run and the LAST page’s truncated/nextCursor.

Backstop run result

Media type application/json
object
ok
required
boolean
dryRun
required
boolean
catchUp
required
boolean
pages

Ticket-sweep pages this request ran (HO-18165); at most the pages asked for.

integer
truncated
required

True when the LAST ticket-sweep page stopped before every candidate was seen (full page or deadline).

boolean
nextCursor
required

The last page’s cursor; pass back as before to continue paging; null when nothing remains.

string | null
earlierSweeps

The sweepUnmergedTickets counters of every page BEFORE the last, in order (the last page is sweep); empty for a one-page request; a null entry is a page that threw.

Array<object | null>
repair

RepairMergedRolesWhereMergedAtSet counters.

object
key
additional properties
any
sweep

The last page’s sweepUnmergedTickets counters; null when that page threw.

object | null
prSweep

SweepRecentGithubPrs counters; null when that sweep threw.

object | null

Malformed before cursor (INVALID_CURSOR) or pages outside 1..2 (INVALID_PAGES)

Missing or invalid CRON_SECRET