dev.knotless.defineLabel

Adds the label to the repository's dev.knotless.repo record, in place of any of its name, as `knotless labels add` does. 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.

Details · procedure
Kindprocedure
Authorityknotless.dev
Indexed

Showing version bafyreidfceuw272kfvfmjq5ztnktnxy4cmcqdvqewaqs52m2w3ycq2fdcu. Show the latest

Procedure

procedure · POST

Input

application/json

color

string

A hex color, as #d73a4a.

  • maxLength: 7

What the label means, for those who put it on.

  • maxLength: 1000
  • maxGraphemes: 200

exclusive

boolean

Whether, of its scope's exclusive labels, it stands alone: setting one takes the others off.

name

requiredstring

Up to its last `/`, if it has one, its scope, as kind/bug's is kind.

  • maxLength: 100
  • maxGraphemes: 50

repo

requiredstring · at-uri

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

Output

application/json

labels

requiredarray

The labels it defines now.

itemsref

Errors

NotFound

No such repository.

InvalidRequest

The name is empty or too long, or the color is no hex color.

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.