dev.knotless.createPull

lexicons.knotless.dev

Documentation

Writes a dev.knotless.pull record in the account logged in to this appview's web pages, as `knotless pull` does: asking to merge a branch of this repository or a fork into one of its branches, both of which must exist. Refused, with the template, when the repository has one at the base (see dev.knotless.getTemplate) and the body follows none of it. Requires the session cookie the pages' login sets.

main procedure

Writes a dev.knotless.pull record in the account logged in to this appview's web pages, as `knotless pull` does: asking to merge a branch of this repository or a fork into one of its branches, both of which must exist. Refused, with the template, when the repository has one at the base (see dev.knotless.getTemplate) and the body follows none of it. Requires the session cookie the pages' login sets.

Input

Encodingapplication/json
base string Required

The branch to merge into.

maxLength: 1024 bytes
body string Optional

What it does and why, in Markdown.

maxLength: 20000 bytes
branch string Required

The branch to bring in.

maxLength: 1024 bytes
draft boolean Optional

Open it as a draft, not ready to merge or queue. Not, when absent.

head stringat-uri Required

The repository the branch is on: this one, or a fork.

images array Optional

Pictures uploaded with dev.knotless.uploadImage; those the body links to are attached.

maxLength: 32 items
repo stringat-uri Required

The repository to merge into: its dev.knotless.repo record, as dev.knotless.getRepo takes it.

title string Required

No description available.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes

Output

Encodingapplication/json
uri stringat-uri Required

The dev.knotless.pull record written.

Errors

NotFound No such repository.
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.pull record in the account logged in to this appview's web pages, as `knotless pull` does: asking to merge a branch of this repository or a fork into one of its branches, both of which must exist. Refused, with the template, when the repository has one at the base (see dev.knotless.getTemplate) and the body follows none of it. Requires the session cookie the pages' login sets.",
  "errors": [
    {
      "description": "No such repository.",
      "name": "NotFound"
    },
    {
      "description": "No account is logged in to the pages, or its session has ended.",
      "name": "AuthenticationRequired"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "base": {
          "description": "The branch to merge into.",
          "maxLength": 1024,
          "type": "string"
        },
        "body": {
          "description": "What it does and why, in Markdown.",
          "maxLength": 20000,
          "type": "string"
        },
        "branch": {
          "description": "The branch to bring in.",
          "maxLength": 1024,
          "type": "string"
        },
        "draft": {
          "description": "Open it as a draft, not ready to merge or queue. Not, when absent.",
          "type": "boolean"
        },
        "head": {
          "description": "The repository the branch is on: this one, or a fork.",
          "format": "at-uri",
          "type": "string"
        },
        "images": {
          "description": "Pictures uploaded with dev.knotless.uploadImage; those the body links to are attached.",
          "items": {
            "ref": "dev.knotless.defs#image",
            "type": "ref"
          },
          "maxLength": 32,
          "type": "array"
        },
        "repo": {
          "description": "The repository to merge into: its dev.knotless.repo record, as dev.knotless.getRepo takes it.",
          "format": "at-uri",
          "type": "string"
        },
        "title": {
          "maxGraphemes": 300,
          "maxLength": 3000,
          "type": "string"
        }
      },
      "required": [
        "repo",
        "base",
        "head",
        "branch",
        "title"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "uri": {
          "description": "The dev.knotless.pull record written.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "uri"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@