dev.knotless.renameBranch

Makes the new branch where the old one is, points the open pulls into the old one at the new, then deletes the old, as `knotless branch rename` does; never the default branch. As the account logged in to this appview's web pages: directly for the owner, through the repository's gateway for a collaborator, which refuses anyone else.

Repository @lexicons.knotless.dev did:plc:yqsg7znbbhfmj3a2nrpnaerk namespace authority

Details · procedure

Kind	procedure
Authority	knotless.dev
Indexed	6d ago · 2026-11-04

Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

name

requiredstring

The branch, without refs/heads/.

maxLength: 255

repo

requiredstring · at-uri

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

to

requiredstring

Its new name.

maxLength: 255

Output

application/json

name

requiredstring

The branch, without refs/heads/.

sha

string

The commit it points at, in hex, once made.

Errors

NotFound

No such repository.

InvalidRequest

There is no such branch, it is the default branch, the new name is taken, or the gateway refused it.

AuthenticationRequired

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

Similar lexicons

semantic match

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

dev.knotless.renameRepo
procedure

Gives a repository a new name.
dev.knotless.deleteBranch
procedure

Deletes a branch of a repository.
dev.knotless.createBranch
procedure

Creates a branch of a repository.
dev.knotless.forkRepo
procedure

Forks a repository into the account logged in to this appview's pages.
dev.knotless.updateRepo
procedure

Changes what a repository says it is, the links its pages show, what it is about and the branch its HEAD names.