Lexicon Garden

dev.knotless.createBranch

Points a new branch at a commit or branch, the default branch when none is named, as `knotless branch` does. 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
Kindprocedure
Authorityknotless.dev
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

from

string

The commit, by hex, or branch it starts at: the default branch when absent.

  • maxLength: 255

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.

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

The branch exists already, there is no such commit or branch to start at, 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.deleteBranch

    procedure

    Deletes a branch of a repository.

  • dev.knotless.renameBranch

    procedure

    Renames a branch of a repository.

  • dev.knotless.createRepo

    procedure

    Creates a repository in the account logged in to this appview's pages.

  • dev.knotless.forkRepo

    procedure

    Forks a repository into the account logged in to this appview's pages.

  • dev.knotless.createCommit

    procedure

    Commits file changes to a branch through a gateway its owner has delegated writes to, without a clone. Commits to one branch that arrive together are built into one chain and written as one ref update. Requires a service token from the caller's PDS, audience the gateway's DID, for this method; the caller must be the owner or a collaborator.