dev.knotless.getLastCommits

lexicons.knotless.dev

Documentation

The newest commit to change each entry of a directory at a revision, as its history shows it: a commit that left an entry as one of its parents had it did not change it. Asked apart from dev.knotless.getTree, as finding them can walk a long history. 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 newest commit to change each entry of a directory at a revision, as its history shows it: a commit that left an entry as one of its parents had it did not change it. Asked apart from dev.knotless.getTree, as finding them can walk a long history. 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

path string Optional

A directory in the tree, from its root.

ref string Optional

A branch, a tag or a commit, which may run on into the path, as dev.knotless.getTree takes it; the default branch if absent.

repo string at-uri Required

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

Output

Encodingapplication/json
commits array Required

Each commit an entry names, once.

entries array Required

Each entry of the directory, in the tree's order.

path string Required

The directory, from the root; empty for the root.

ref string Required

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

Errors

NotFound No such repository, revision or directory.
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
A directory in the tree, from its root.
A branch, a tag or a commit, which may run on into the path, as dev.knotless.getTree takes it; the default branch if absent.
The repository's dev.knotless.repo record, as dev.knotless.getTree takes it.
View raw schema 
{
  "description": "The newest commit to change each entry of a directory at a revision, as its history shows it: a commit that left an entry as one of its parents had it did not change it. Asked apart from dev.knotless.getTree, as finding them can walk a long history. 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 or directory.",
      "name": "NotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "commits": {
          "description": "Each commit an entry names, once.",
          "items": {
            "ref": "dev.knotless.defs#commitView",
            "type": "ref"
          },
          "type": "array"
        },
        "entries": {
          "description": "Each entry of the directory, in the tree's order.",
          "items": {
            "ref": "#entry",
            "type": "ref"
          },
          "type": "array"
        },
        "path": {
          "description": "The directory, from the root; empty for the root.",
          "type": "string"
        },
        "ref": {
          "description": "The ref or commit shown, as `ref` named it, less any path.",
          "type": "string"
        }
      },
      "required": [
        "ref",
        "path",
        "entries",
        "commits"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "path": {
        "description": "A directory in the tree, from its root.",
        "maxLength": 4096,
        "type": "string"
      },
      "ref": {
        "description": "A branch, a tag or a commit, which may run on into the path, as dev.knotless.getTree takes it; the default branch if absent.",
        "maxLength": 1024,
        "type": "string"
      },
      "repo": {
        "description": "The repository's dev.knotless.repo record, as dev.knotless.getTree takes it.",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "repo"
    ],
    "type": "params"
  },
  "type": "query"
}
entry object

One entry of the directory, and the commit that last changed it.

Properties

name string Required

The entry's name in the directory.

sha string Required

The commit that last changed it, in hex: one of `commits`.

View raw schema 
{
  "description": "One entry of the directory, and the commit that last changed it.",
  "properties": {
    "name": {
      "description": "The entry's name in the directory.",
      "type": "string"
    },
    "sha": {
      "description": "The commit that last changed it, in hex: one of `commits`.",
      "type": "string"
    }
  },
  "required": [
    "name",
    "sha"
  ],
  "type": "object"
}

Lexicon Garden

@