dev.knotless.getLastCommits

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.

Details · query
Kindquery
Authorityknotless.dev
Indexed

Query

query · GET

Parameters

query string

path

string

A directory in the tree, from its root.

  • maxLength: 4096

ref

string

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

repo

requiredstring · at-uri

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

Output

application/json

How many commits the ref's history holds, its own among them. Only when `path` is the root.

  • minimum: 0

commits

requiredarray

Each commit an entry names, once.

itemsref

entries

requiredarray

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

itemsref
Reference

path

requiredstring

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

ref

requiredstring

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

Errors

NotFound

No such repository, revision or directory.

#entry

object

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

Properties

name

requiredstring

The entry's name in the directory.

sha

requiredstring

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

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.