dev.knotless.getFeed Documentation (EN)

main query

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.

Parameters

actor string did Optional

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 Optional

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

filter string Optional

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

kind string Optional

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.

limit integer Optional

No description available.

Output

Encodingapplication/json

cursor string Optional

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

events array Required

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

actor 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 Where the page starts: a previous page's cursor.

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

kind 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.

limit

View raw schema

{
  "description": "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.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "description": "Where the next page starts, when there may be one.",
          "type": "string"
        },
        "events": {
          "items": {
            "ref": "#eventView",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "events"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "actor": {
        "description": "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.",
        "format": "did",
        "type": "string"
      },
      "cursor": {
        "description": "Where the page starts: a previous page's cursor.",
        "type": "string"
      },
      "filter": {
        "default": "everyone",
        "description": "Whose doings: `everyone`'s, or with `following`, those of the account asking and whom it follows, which needs an account to ask.",
        "knownValues": [
          "everyone",
          "following"
        ],
        "type": "string"
      },
      "kind": {
        "description": "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"
        ],
        "type": "string"
      },
      "limit": {
        "default": 40,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      }
    },
    "type": "params"
  },
  "type": "query"
}

actorView object

No description available.

Properties

avatar string uri Optional

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

did string did Required

A decentralized identifier (DID).

handle string Required

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

View raw schema

{
  "properties": {
    "avatar": {
      "description": "The account's picture, as in dev.knotless.getProfile#profileView.",
      "format": "uri",
      "type": "string"
    },
    "did": {
      "format": "did",
      "type": "string"
    },
    "handle": {
      "description": "The handle the account claims, when it resolves back to it; else the DID.",
      "type": "string"
    }
  },
  "required": [
    "did",
    "handle"
  ],
  "type": "object"
}

changed object

A pull or an issue moved to another state.

Properties

state string Required

No description available.

Known values: open, closed, merged

subject string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

title string Required

The subject's title.

View raw schema

{
  "description": "A pull or an issue moved to another state.",
  "properties": {
    "state": {
      "knownValues": [
        "open",
        "closed",
        "merged"
      ],
      "type": "string"
    },
    "subject": {
      "format": "at-uri",
      "type": "string"
    },
    "title": {
      "description": "The subject's title.",
      "type": "string"
    }
  },
  "required": [
    "subject",
    "title",
    "state"
  ],
  "type": "object"
}

commented object

A comment or review on a pull or an issue.

Properties

subject string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

text string Required

The comment, as Markdown.

title string Required

The subject's title.

verdict string Optional

No description available.

Known values: approve, changes

View raw schema

{
  "description": "A comment or review on a pull or an issue.",
  "properties": {
    "subject": {
      "format": "at-uri",
      "type": "string"
    },
    "text": {
      "description": "The comment, as Markdown.",
      "type": "string"
    },
    "title": {
      "description": "The subject's title.",
      "type": "string"
    },
    "verdict": {
      "knownValues": [
        "approve",
        "changes"
      ],
      "type": "string"
    }
  },
  "required": [
    "subject",
    "title",
    "text"
  ],
  "type": "object"
}

commitView object

No description available.

Properties

merge boolean Optional

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

message string Required

No description available.

sha string Required

No description available.

View raw schema

{
  "properties": {
    "merge": {
      "description": "Whether the commit has more than one parent. Absent when not.",
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "sha": {
      "type": "string"
    }
  },
  "required": [
    "sha",
    "message"
  ],
  "type": "object"
}

created object

A repository created, or forked from another.

Properties

description string Optional

No description available.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes

forkOf ref #repoView Optional

No description available.

View raw schema

{
  "description": "A repository created, or forked from another.",
  "properties": {
    "description": {
      "maxGraphemes": 300,
      "maxLength": 3000,
      "type": "string"
    },
    "forkOf": {
      "ref": "#repoView",
      "type": "ref"
    }
  },
  "type": "object"
}

deleted object

A ref deleted.

Properties

ref string Required

No description available.

View raw schema

{
  "description": "A ref deleted.",
  "properties": {
    "ref": {
      "type": "string"
    }
  },
  "required": [
    "ref"
  ],
  "type": "object"
}

eventView object

Something an account did to a repository.

Properties

action union Required

No description available.

Known types:

#created
#pushed
#deleted
#opened
#commented
#changed
#starred

actor ref #actorView Required

No description available.

createdAt string datetime Required

When the record saying so was made.

repo ref #repoView Required

No description available.

View raw schema

{
  "description": "Something an account did to a repository.",
  "properties": {
    "action": {
      "refs": [
        "#created",
        "#pushed",
        "#deleted",
        "#opened",
        "#commented",
        "#changed",
        "#starred"
      ],
      "type": "union"
    },
    "actor": {
      "ref": "#actorView",
      "type": "ref"
    },
    "createdAt": {
      "description": "When the record saying so was made.",
      "format": "datetime",
      "type": "string"
    },
    "repo": {
      "ref": "#repoView",
      "type": "ref"
    }
  },
  "required": [
    "createdAt",
    "actor",
    "repo",
    "action"
  ],
  "type": "object"
}

opened object

A pull or an issue opened.

Properties

subject string at-uri Required

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

title string Required

No description available.

View raw schema

{
  "description": "A pull or an issue opened.",
  "properties": {
    "subject": {
      "description": "The dev.knotless.pull or dev.knotless.issue record.",
      "format": "at-uri",
      "type": "string"
    },
    "title": {
      "type": "string"
    }
  },
  "required": [
    "subject",
    "title"
  ],
  "type": "object"
}

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 array of ref#commitView Required

The newest of the new ones, newest first.

maxLength: 10 items

count integer Required

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: 0maximum: 100

created boolean Required

Whether the ref was new.

forced boolean Optional

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 integer Required

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: 0maximum: 100

ref string Required

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

View raw schema

{
  "description": "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": {
      "description": "The newest of the new ones, newest first.",
      "items": {
        "ref": "#commitView",
        "type": "ref"
      },
      "maxLength": 10,
      "type": "array"
    },
    "count": {
      "description": "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.",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "created": {
      "description": "Whether the ref was new.",
      "type": "boolean"
    },
    "forced": {
      "description": "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.",
      "type": "boolean"
    },
    "new": {
      "description": "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.",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "ref": {
      "description": "The full ref name, such as refs/heads/main.",
      "type": "string"
    }
  },
  "required": [
    "ref",
    "created",
    "count",
    "new",
    "commits"
  ],
  "type": "object"
}

repoView object

A repository, under the name it has now.

Properties

did string did Required

The repository's owner.

handle string Required

The owner's handle, as in #actorView.

name string Required

No description available.

maxLength: 100 bytes

View raw schema

{
  "description": "A repository, under the name it has now.",
  "properties": {
    "did": {
      "description": "The repository's owner.",
      "format": "did",
      "type": "string"
    },
    "handle": {
      "description": "The owner's handle, as in #actorView.",
      "type": "string"
    },
    "name": {
      "maxLength": 100,
      "type": "string"
    }
  },
  "required": [
    "did",
    "handle",
    "name"
  ],
  "type": "object"
}

starred object

The event's repository starred.

Properties

subject string at-uri Optional

The dev.knotless.repo record starred.

View raw schema

{
  "description": "The event's repository starred.",
  "properties": {
    "subject": {
      "description": "The dev.knotless.repo record starred.",
      "format": "at-uri",
      "type": "string"
    }
  },
  "type": "object"
}