fyi.opensocial.listSiteRecords
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "Records of one collection from the host's index, newest first. Without `repo`, a collection the group's site declares it reads, from the group (answered to anyone) or its members (members only). With `repo`, that one account's records — the group's or a member's — of any collection, kept on demand once asked for; members only. `field` and `equals` keep only records whose field (a name, or a path like subject.uri) equals that value. With `from: \"network\"`, everyone's records of the collection, from every account on the network that writes it: answered to anyone once the host keeps it, and kept from when a member first asks for it, unless too many accounts write it; `filling` says it is still being gathered.",
"errors": [
{
"name": "NotFound"
},
{
"name": "NotDeclared"
},
{
"name": "NotAuthorized"
},
{
"name": "NotKept"
},
{
"name": "TooLarge"
},
{
"name": "TooMany"
}
],
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cursor": {
"description": "With `from: \"network\"`, when there are older records.",
"type": "string"
},
"filling": {
"description": "With `from: \"network\"`: the host is still gathering the collection, so older records may be missing.",
"type": "boolean"
},
"records": {
"items": {
"ref": "#siteRecord",
"type": "ref"
},
"type": "array"
}
},
"required": [
"records"
],
"type": "object"
}
},
"parameters": {
"properties": {
"collection": {
"format": "nsid",
"type": "string"
},
"cursor": {
"description": "With `from: \"network\"`: from the last page, for older records.",
"maxLength": 1024,
"type": "string"
},
"equals": {
"maxLength": 2048,
"type": "string"
},
"field": {
"description": "Only records whose field (a name or a dotted path) equals `equals`.",
"maxLength": 128,
"type": "string"
},
"from": {
"description": "Without `repo`: the group's records, its members', or everyone's on the network.",
"knownValues": [
"group",
"members",
"network"
],
"type": "string"
},
"group": {
"format": "did",
"type": "string"
},
"limit": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"repo": {
"description": "One account's records: the group's or a member's.",
"format": "did",
"type": "string"
},
"search": {
"description": "With `from: \"network\"`: only records whose words include any of these words or \"quoted phrases\".",
"maxLength": 512,
"type": "string"
}
},
"required": [
"group",
"collection"
],
"type": "params"
},
"type": "query"
},
"siteRecord": {
"properties": {
"createdAt": {
"format": "datetime",
"type": "string"
},
"repo": {
"format": "did",
"type": "string"
},
"uri": {
"format": "at-uri",
"type": "string"
},
"value": {
"type": "unknown"
}
},
"required": [
"uri",
"repo",
"value"
],
"type": "object"
}
},
"id": "fyi.opensocial.listSiteRecords",
"lexicon": 1
}
Metadata
- DID
-
did:plc:2gqnilpksz2e7faj3bwvo6qc - CID
-
bafyreihzzr77eblkrkx6qzxn4i3jgnxe6dkv34lprk5pf5fijhmcebqpom - Indexed At
- 2026-10-09 19:44 UTC
- AT-URI
-
at://did:plc:2gqnilpksz2e7faj3bwvo6qc/com.atproto.lexicon.schema/fyi.opensocial.listSiteRecords
Version History (4 versions)
Similar Lexicons
Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Records in one of a group's content spaces, from the host's index of it: one collection or every collection, newest first, a page at a time. Only for those the space's own access record lets read, checked on every call,…
-
List a range of records in a repository, matching a specific collection. Does not require auth.