at.protocube.listRecords

List protocube records by tag (feed/tag pages, newest-indexed first) or by repository (author pages, descending record key).

Repository @protocube.at did:plc:it2qbdcai2lchnnnt3caynqx namespace authority
Details · query
Kindquery
Authorityprotocube.at
Commit rev3mzxpo5gco62v
Indexed

Query

query · GET

Parameters

query string

collection

requiredstring · nsid

at.protocube.walkthrough, at.protocube.series or at.protocube.path.

cursor

string

did

string · did

Repository filter. Requires order=rkey and excludes tag.

limit

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

order

string

newest = indexed_at DESC, uri DESC. rkey = record key DESC for one repository.

  • default: "newest"
  • enum: newest | rkey

tag

string

Full tag string, e.g. tag:protocube. Requires order=newest and excludes did.

  • maxLength: 64

Output

application/json

cursor

string

records

requiredarray
itemsref
Reference

Errors

InvalidRequest

No description in schema.

#recordView

object

Properties

cid

requiredstring · cid

uri

requiredstring · at-uri

value

requiredunknown

The raw record value. The AppView never flattens or rewrites it; the client validates it.

Similar lexicons

semantic match

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

  • List a range of records in a repository, matching a specific collection. Does not require auth.

  • Full-state recovery: enumerate a repo's record paths and their current CIDs, mirroring listRecords semantics. Record values are inlined by default; excludeValues returns metadata only. Boundary-gated: the caller only observes records within its enrolled boundaries. Intended as the fallback when the oplog (listRepoOps) returns OplogTruncated: the caller enumerates paths, diffs locally, and fetches misses. Callers must authenticate with a signed service JWT via the Authorization: Bearer header.

  • Read one at.protocube.series record by repository and record key from the protocube AppView.

  • Every version of a record this knot hosts, oldest first unless order says otherwise. A version's bytes are fetched by content id through com.atproto.sync.getBlocks.

  • List records of a given collection within a space. Access is governed by the space's collection policy.