dev.knotless.getQueue

What is queued on each branch of a repository, in the order it lands, the batches being checked, the open pulls the queue turned away and why, and the batches it landed last, as the runners the repository names report them. No authentication; responses are not personalized.

Details · query
Kindquery
Authorityknotless.dev
Indexed

Query

query · GET

Parameters

query string

repo

requiredstring · at-uri

The repository's dev.knotless.repo record. Its authority may be a handle; a name the repository had before, or an owner it moved from with its agreement, finds it under the name it has now.

Output

application/json

branches

requiredarray

Each branch with pulls queued, by name.

itemsref
Reference

ejected

requiredarray

The open pulls the queue turned away, newest first.

itemsref
Reference

landed

requiredarray

The last few batches landed, newest first.

itemsref
Reference

How long its merge queue typically takes; absent with no batch landed to go by.

Errors

NotFound

No such repository; or this appview keeps no index, so it knows no pulls.

#batchView

object

A batch being checked, or landing once its checks have passed.

Properties

checks

requiredarray

The newest run of each workflow at its commit.

itemsref

commit

requiredstring

The commit it would leave the branch at, in hex.

size

requiredinteger

How many pulls are in it.

  • minimum: 1

startedAt

string · datetime

When its first run started.

state

requiredstring
  • knownValues: checking | landing

#branchView

object

A branch's merge queue.

Properties

batches

requiredarray

The batches being checked or landing, in the order they land: a pull names the one it is in.

itemsref
Reference

branch

requiredstring

The branch's name.

pulls

requiredarray

In the order they land.

itemsref
Reference

#ejectedView

object

A pull the merge queue turned away.

Properties

checks

requiredarray

The checks of its batch that did not pass, if they are why.

itemsref

ejectedAt

requiredstring · datetime

pull

requiredref

reason

string

Why, as the runner said.

#landedView

object

A batch the merge queue landed.

Properties

branch

requiredstring

The branch's name.

commit

requiredstring

The commit it left the branch at, in hex.

landedAt

string · datetime

pulls

requiredarray

In the order they were squashed onto the branch.

itemsref

#queuedView

object

A pull in a merge queue.

Properties

batch

integer

The batch it is in, by its place in its branch's `batches`.

  • minimum: 0

checks

array

Until it is in a batch, the newest run of each of its pre-flights.

itemsref

pull

requiredref

queuedAt

requiredstring · datetime

said

requiredstring

Where it stands, in words: `Queued, 3rd of 5, running its checks`, `In a batch of 4 being checked` or `Landing`.

stage

string

Where it stands: `queued`, with no run of its pre-flights seen yet; `preflight`, its pre-flights running at its head; `again`, one of them run again as one failed on an older tip of its branch; `ready`, its pre-flights passed, waiting for the next batch; `review`, its pre-flights passed, waiting for a review of its head from its branch's gates; `checking`, in a batch being checked; `landing`; or `stacked`, waiting for the pull below it to land.

  • knownValues: queued | preflight | again | ready | review | checking | landing

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A pull put in the merge queue of the branch it targets, taken out of it, or turned away by the runner that lands the queue.

  • Puts a pull in its branch's merge queue as the account logged in to this appview's pages.

  • Whether an open pull can merge now, and what the account asking may do to it.

  • What a workflow did at a commit a ref pointed at, or at the head of a pull, as the runner that ran it reports.

  • Takes a pull out of its branch's merge queue as the account logged in to this appview's pages.