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.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | sync.grain.social |
| Commit rev | 3n2sngsrimybg |
| Indexed |
Procedure
procedure · POSTInput
application/jsonRecords in the caller's own repo, just created, updated or deleted.
maxLength: 25
Output
application/jsonEach record named, once, as its PDS proved it.
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
objectA record as it is now.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
fyi.opensocial.refreshRecords
procedureRead 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.
-
social.grain.sync.indexRecords
procedureDeprecated: 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.
-
pub.chive.sync.refreshRecord
procedureRefresh a stale record from PDS