dev.knotless.getFeed

What happened on the public repositories an appview has indexed, newest first: repositories created and forked, refs pushed and deleted, pulls and issues opened, discussed and moved between states, and repositories starred. With filter `following`, what the account asking and those it follows did, and anything done on its repositories and those it starred; without, the same for anyone, but no stars. Without `actor`, what a repository's bots said or pushed on it is left out: the runners and triagers its record names, but its owner and collaborators. A pull a runner merged landing the merge queue is shown as merged by whoever queued it.

Details · query
Kindquery
Authorityknotless.dev
Indexed

Query

query · GET

Parameters

query string

actor

string · did

Only what this account did: the repositories it created, the refs it pushed, the pulls, issues, comments and changes of state it wrote, and the repositories it starred.

cursor

string

Where the page starts: a previous page's cursor.

filter

string

Whose doings: `everyone`'s, or with `following`, those of the account asking and whom it follows, which needs an account to ask.

  • default: "everyone"
  • knownValues: everyone | following

kind

string

Only what is of this kind: refs pushed and deleted, pulls or issues opened and moved between states, comments, repositories starred, or repositories created and forked. A kind the appview does not know answers nothing.

  • knownValues: pushes | pulls | issues | comments | stars | repos

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 40

Output

application/json

cursor

string

Where the next page starts, when there may be one.

events

requiredarray
itemsref
Reference

#actorView

object

Properties

avatar

string · uri

The account's picture, as in dev.knotless.getProfile#profileView.

bot

boolean

Whether its knotless profile says it is a bot, as in dev.knotless.defs#actorView.

did

requiredstring · did

handle

requiredstring

The handle the account claims, when it resolves back to it; else the DID.

#changed

object

A pull or an issue moved to another state.

Properties

state

requiredstring
  • knownValues: open | closed | merged

subject

requiredstring · at-uri

Where the subject stands now, whoever moved it there.

  • knownValues: open | closed | merged

title

requiredstring

The subject's title.

#commented

object

A comment or review on a pull or an issue.

Properties

subject

requiredstring · at-uri

Where the subject stands now, whoever moved it there.

  • knownValues: open | closed | merged

text

requiredstring

The comment, as Markdown.

title

requiredstring

The subject's title.

verdict

string
  • knownValues: approve | changes

#commitView

object

Properties

merge

boolean

Whether the commit has more than one parent. Absent when not.

message

requiredstring

sha

requiredstring

#created

object

A repository created, or forked from another.

Properties

  • maxLength: 3000
  • maxGraphemes: 300
Reference

#deleted

object

A ref deleted.

Properties

ref

requiredstring

#eventView

object

Something an account did to a repository.

Properties

actor

requiredref
Reference

createdAt

requiredstring · datetime

When the record saying so was made.

repo

requiredref
Reference

#opened

object

A pull or an issue opened.

Properties

subject

requiredstring · at-uri

The dev.knotless.pull or dev.knotless.issue record.

Where the subject stands now, whoever moved it there.

  • knownValues: open | closed | merged

title

requiredstring

#pushed

object

A ref created or moved, or moved again and again by one account, each move within an hour of the last, as one. A new ref brings what the repository's default branch did not reach just before, nor its fork source's; a fork's copies of its source's refs are not events.

Properties

commits

requiredarray

The newest of the new ones, newest first.

  • maxLength: 10
itemsref
Reference

count

requiredinteger

Commits the push brought; 100 means at least that many. A forced push's leave out those it brought again: the same author, at the same time, with the same message as a commit it left behind.

  • minimum: 0
  • maximum: 100

created

requiredboolean

Whether the ref was new.

forced

boolean

Whether the ref moved to where it no longer reaches some of what it did, as a rebase or a rewrite does. Absent when not.

new

requiredinteger

Of those, the commits no other ref of the repository had before, and no event before it on the same page lists; the rest are only counted.

  • minimum: 0
  • maximum: 100

ref

requiredstring

The full ref name, such as refs/heads/main.

to

string

The commit the ref was left at, in hex: what the push brought, which a page can link to after the ref is gone.

#repoView

object

A repository, under the name it has now.

Properties

did

requiredstring · did

The repository's owner.

handle

requiredstring

The owner's handle, as in #actorView.

name

requiredstring
  • maxLength: 100

#starred

object

The event's repository starred.

Properties

subject

string · at-uri

The dev.knotless.repo record starred.

Similar lexicons

semantic match

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