social.grain.sync.refreshRecords

Read records of the caller's own again from their own PDS, proved (com.atproto.sync.getRecord: the commit signed by the account's key, the record reached from the tree it signed), and keep each, or its absence, at that commit's revision wherever the index keeps its collection: what a client just wrote or deleted shows at once, rather than when the network brings it, and the network's copy of the same revision or an older one changes nothing. A record of a collection grain does not index, or that does not fit its lexicon, is left alone. Requires service auth, or the web's session cookie from a page of the site.

Repository @grain.social did:plc:e7rftrdyz5e2rw4y6ocszew2 namespace authority
Details · procedure
Kindprocedure
Authoritysync.grain.social
Commit rev3n2sngsrimybg
Indexed

Procedure

procedure · POST

Input

application/json

uris

requiredarray

Records in the caller's own repo, just created, updated or deleted.

  • maxLength: 25
itemsstring · at-uri

Output

application/json

records

requiredarray

Each record named, once, as its PDS proved it.

itemsref
Reference

Errors

NotYours

A URI names a record in a repo other than the caller's.

Unreachable

The caller's PDS did not answer for a record, or did not prove what it answered.

#recordView

object

A record as it is now.

Properties

cid

string · cid

Its CID as it is now; left out once it is gone.

uri

requiredstring · at-uri

Similar lexicons

semantic match

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

  • Read records of the caller's own again from their own server, proved (com.atproto.sync.getRecord), and keep them as they are now wherever the host keeps their collection: what a site just wrote or deleted for them shows at once, rather than when the network brings it. A record the host doesn't keep is left alone.

  • Deprecated: use social.grain.sync.refreshRecords, which this is answered from, in its own shape, for apps built before it. Index records the caller has just written to their own PDS, without waiting for the firehose. The server reads each one back from the caller's PDS, proved, before answering, so a read after this sees the write. Requires service auth; every URI must name the caller's repo.

  • Refresh a stale record from PDS