dev.knotless.revertPull

Reverts a merged pull as `knotless pull revert` does, as the account logged in to this appview's web pages, with the session the appview keeps for it: one commit undoing what its merge brought in, on a new branch revert/<the pull's record key> cut from its target branch as it is now, and a pull of that branch into the target branch, which this answers. Nothing merges: the revert is a pull like any other. Refused on a pull that is not merged, when undoing it conflicts with what the branch took since, and to anyone but the repository's owner and collaborators. Requires the session cookie the pages' login sets.

Details · procedure
Kindprocedure
Authorityknotless.dev
Indexed

Procedure

procedure · POST

Input

application/json

pull

requiredstring · at-uri

The merged dev.knotless.pull record.

reason

string

Why, said in the revert's body.

  • maxLength: 10000
  • maxGraphemes: 1000

repo

requiredstring · at-uri

The repository's dev.knotless.repo record, as dev.knotless.getRepo takes it.

Output

application/json

branch

requiredstring

The branch holding the revert, without refs/heads/.

commit

requiredstring

The revert's commit, in hex.

uri

requiredstring · at-uri

The new dev.knotless.pull record, which brings the revert in.

Errors

NotFound

No such repository.

AuthenticationRequired

No account is logged in to the pages, or its session has ended.

UpstreamFailure

It did not revert, as the reason says: the pull is not merged, undoing it conflicts, or the account may not revert it.

Similar lexicons

semantic match

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

  • Merges a pull as the account logged in to this appview's pages.

  • Points a pull at other branches as the account logged in to this appview's pages.

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

  • Sets a pull to merge by itself once its checks pass, or cancels that, as the account logged in to this appview's pages.

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