dev.knotless.listCommits

lexicons.knotless.dev

Documentation

The commits reachable from a revision that changed a path, newest first, a page at a time: follow `cursor` until it is absent. A repository never pushed has none at its default branch. No authentication needed; asked as an account, with a service token or the pages' session cookie, a private repository it is a member of is read too, and the answer is that account's alone.

main query

The commits reachable from a revision that changed a path, newest first, a page at a time: follow `cursor` until it is absent. A repository never pushed has none at its default branch. No authentication needed; asked as an account, with a service token or the pages' session cookie, a private repository it is a member of is read too, and the answer is that account's alone.

Parameters

cursor string Optional

How many commits the pages before held.

limit integer Optional

No description available.

path string Optional

A path in the tree, from its root.

ref string Optional

A branch, a tag or a commit; the default branch if absent. It may run on into the path, as a web address names them: the longest branch or tag that starts it is the ref, and what follows goes before `path`.

repo string at-uri Required

The repository's dev.knotless.repo record. Its authority may be a handle; a name the repository had before, or an owner it moved from with its agreement, finds it under the name it has now.

subjectOnly boolean Optional

Each commit's message cut to its first line, its subject, as a list of commits shows it: far less to send when squashed pulls carry their bodies.

Output

Encodingapplication/json
checks array Optional

The newest run of each workflow at each of `commits`, by the runners the repository names; each says its commit.

commits array Required

No description available.

cursor string Optional

Absent on the last page.

path string Required

The path, from the root; empty for the whole tree.

ref string Required

The ref or commit shown, as `ref` named it, less any path.

Errors

NotFound No such repository, revision, path or record.
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://api.bsky.social)
Parameters
How many commits the pages before held.
A path in the tree, from its root.
A branch, a tag or a commit; the default branch if absent. It may run on into the path, as a web address names them: the longest branch or tag that starts it is the ref, and what follows goes before `path`.
The repository's dev.knotless.repo record. Its authority may be a handle; a name the repository had before, or an owner it moved from with its agreement, finds it under the name it has now.
Each commit's message cut to its first line, its subject, as a list of commits shows it: far less to send when squashed pulls carry their bodies.
View raw schema
{
  "description": "The commits reachable from a revision that changed a path, newest first, a page at a time: follow `cursor` until it is absent. A repository never pushed has none at its default branch. No authentication needed; asked as an account, with a service token or the pages' session cookie, a private repository it is a member of is read too, and the answer is that account's alone.",
  "errors": [
    {
      "description": "No such repository, revision, path or record.",
      "name": "NotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "checks": {
          "description": "The newest run of each workflow at each of `commits`, by the runners the repository names; each says its commit.",
          "items": {
            "ref": "dev.knotless.defs#checkView",
            "type": "ref"
          },
          "type": "array"
        },
        "commits": {
          "items": {
            "ref": "dev.knotless.defs#commitView",
            "type": "ref"
          },
          "type": "array"
        },
        "cursor": {
          "description": "Absent on the last page.",
          "type": "string"
        },
        "path": {
          "description": "The path, from the root; empty for the whole tree.",
          "type": "string"
        },
        "ref": {
          "description": "The ref or commit shown, as `ref` named it, less any path.",
          "type": "string"
        }
      },
      "required": [
        "ref",
        "path",
        "commits"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "description": "How many commits the pages before held.",
        "maxLength": 32,
        "type": "string"
      },
      "limit": {
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "path": {
        "description": "A path in the tree, from its root.",
        "maxLength": 4096,
        "type": "string"
      },
      "ref": {
        "description": "A branch, a tag or a commit; the default branch if absent. It may run on into the path, as a web address names them: the longest branch or tag that starts it is the ref, and what follows goes before `path`.",
        "maxLength": 1024,
        "type": "string"
      },
      "repo": {
        "description": "The repository's dev.knotless.repo record. Its authority may be a handle; a name the repository had before, or an owner it moved from with its agreement, finds it under the name it has now.",
        "format": "at-uri",
        "type": "string"
      },
      "subjectOnly": {
        "default": false,
        "description": "Each commit's message cut to its first line, its subject, as a list of commits shows it: far less to send when squashed pulls carry their bodies.",
        "type": "boolean"
      }
    },
    "required": [
      "repo"
    ],
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@