AT Protocol icon

AT Protocol

CRUD records and manage blobs in any AT Protocol repo

Actions8

Record → List

AI-generated

Summary

Lists records in a selected AT Protocol collection from the authenticated user’s repository or an optional repository identified by DID or handle. Fetches one page using the supplied limit and cursor, or follows pages when Return All is enabled.

Inputs

  • Collection (required) — Choose a collection from the list or enter its NSID, such as app.bsky.feed.post.
  • Repo (DID or Handle) — Repository to read from; defaults to the authenticated user. A handle is resolved to a DID, and another user’s public records are read from their PDS.
  • Return All — When enabled, retrieves successive pages of up to 100 records until there is no next cursor or the 1,000-page cap is reached. When disabled, uses Limit and Cursor.
  • Limit — Maximum records to request for this page when Return All is disabled; defaults to 50 and accepts 1–1,000.
  • Cursor — Pagination cursor from a previous response, used to request the next page when Return All is disabled.

Output shape

A single item containing a records array; each record has uri, cid, and value.

With Return All disabled, also returns cursor when the service provides one; pass it to Cursor to continue. With Return All enabled, returns the accumulated records array without a cursor.

Links

Discussion