dev.knotless.updateRepo

Rewrites the repository's dev.knotless.repo record with a new description, new links, new topics or a new default branch, any of them, as `knotless repo edit` does. The default branch must be one of its branches, once it has any. Its owner can, logged in to this appview's web pages: the appview writes with the session it keeps for that account, which the pages' session cookie names. For an organization's repository, so can an admin who joined it, logged in to the pages or with a service token from their own PDS for this method: the appview's gateway, which the organization delegated its writes to, writes as the organization.

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

defaultBranch

string

The branch its HEAD names, without refs/heads/. Left as it is when absent.

maxLength: 255

description

string

What the repository is; empty drops it. Left as it is when absent.

maxLength: 3000
maxGraphemes: 300

repo

requiredstring · at-uri

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

topics

array

What it is about, in order, each of lowercase letters, digits and dashes. Replaces those it had; empty drops them. Left as they are when absent.

maxLength: 20

itemsref

Reference

dev.knotless.repo#topic

Output

application/json

defaultBranch

string

The branch its HEAD names now.

description

string

What it says it is now; absent when it says nothing.

topics

array

What it is about now; absent when it names nothing.

itemsref

Reference

dev.knotless.repo#topic

Errors

NotFound

No such repository.

InvalidRequest

None was given, the description is too long, a link is not an http or https address or there are too many, a topic is not lowercase letters, digits and dashes or there are too many, or the repository has no such branch.

AuthenticationRequired

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

Forbidden

The account logged in is not the repository's owner.

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.createRepo
procedure

Creates a repository in the account logged in to this appview's pages.
dev.knotless.renameBranch
procedure

Renames a branch of a repository.
dev.knotless.getRepoSettings
query

What a repository's owner sets: its description, links, topics and default branch, protected branches, labels, collaborators and triagers, and an offer to move it.
dev.knotless.editItem
procedure

Changes what a pull, an issue or a comment says, as its author, logged in to this appview's pages.