The pub.oysters.* lexicons
Every submission and comment on oyste.rs is a record in its author's repository, shaped by these schemas. They are public so that any client can read and write the same records, and any appview can index them.
Records
What lives in a user's repository. Anyone can write these.Queries
The read API, served by the appview at oyste.rs/xrpc.- pub.oysters.getActorPostsqueryOne account's submissions, most recently indexed first.
- pub.oysters.getFeedqueryA page of the board's feed. Public: no authentication, and the same answer for everybody.
- pub.oysters.getPostThreadqueryA submission and its discussion.
- pub.oysters.getTagsqueryThe board's curated tag vocabulary. A submission may carry any tag it likes; only these are indexed, filterable, and shown.
Shared definitions
Views and objects the queries return.Permissions
What you approve when you sign in to oyste.rs.Votes
Votes are not ours. Oysters reuses the community's shared like record,community.lexicon.interaction.like, so a vote here is a like any other client understands.
Resolving them
| Authority | _lexicon.oysters.pub TXT → did=did:plc:gsvuczfwpmrqpap45iz23j43 |
|---|---|
| Authoritative copy | com.atproto.lexicon.schema records in that repository. This is what a strict resolver reads. |
| Mirror (JSON) | https://oysters.pub/lexicons and /lexicons/<nsid>. Convenient, not authoritative. |
| Source | priv/lexicons in the Oysters repository. These pages, the mirror and the published records all come from the same files. |