dev.knotless.createRepo

lexicons.knotless.dev

Documentation

Writes a dev.knotless.repo record under the name given in the account logged in to this appview's web pages, as `knotless create` does: public unless asked for private, naming the runners the appview offers for new repositories, and with no branches until the first push. Requires the session cookie the pages' login sets: the appview writes with the session it keeps for that account. Clients holding their own session write the record themselves.

main procedure

Writes a dev.knotless.repo record under the name given in the account logged in to this appview's web pages, as `knotless create` does: public unless asked for private, naming the runners the appview offers for new repositories, and with no branches until the first push. Requires the session cookie the pages' login sets: the appview writes with the session it keeps for that account. Clients holding their own session write the record themselves.

Input

Encodingapplication/json
defaultBranch string Optional

The branch its HEAD names, without refs/heads/: main when absent.

maxLength: 255 bytes
description string Optional

What the repository is, shown under its name.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes
name string Required

The repository's name, its record key.

maxLength: 100 bytes
private boolean Optional

Whether to make it private, as `knotless create --private` does: a space of its own on the account's PDS, which only its members read, its runners among them. Public when absent.

Output

Encodingapplication/json
Schemadev.knotless.defs#repoMade

Errors

InvalidRequest The name is not one a repository can have, or the account has a repository by it already.
AuthenticationRequired No account is logged in to the pages, or its session has ended.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "description": "Writes a dev.knotless.repo record under the name given in the account logged in to this appview's web pages, as `knotless create` does: public unless asked for private, naming the runners the appview offers for new repositories, and with no branches until the first push. Requires the session cookie the pages' login sets: the appview writes with the session it keeps for that account. Clients holding their own session write the record themselves.",
  "errors": [
    {
      "description": "The name is not one a repository can have, or the account has a repository by it already.",
      "name": "InvalidRequest"
    },
    {
      "description": "No account is logged in to the pages, or its session has ended.",
      "name": "AuthenticationRequired"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "defaultBranch": {
          "description": "The branch its HEAD names, without refs/heads/: main when absent.",
          "maxLength": 255,
          "type": "string"
        },
        "description": {
          "description": "What the repository is, shown under its name.",
          "maxGraphemes": 300,
          "maxLength": 3000,
          "type": "string"
        },
        "name": {
          "description": "The repository's name, its record key.",
          "maxLength": 100,
          "type": "string"
        },
        "private": {
          "description": "Whether to make it private, as `knotless create --private` does: a space of its own on the account's PDS, which only its members read, its runners among them. Public when absent.",
          "type": "boolean"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "ref": "dev.knotless.defs#repoMade",
      "type": "ref"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@