pub.techne.draft.sync.indexRecord
A hint sent right after a write. It says "I just wrote this public record."
The platform fetches the record from its author's PDS, verifies the proof the way it verifies the firehose, and indexes it ahead of the relay. The hint carries no body and is never needed. A record that is never hinted is still indexed when the relay brings it. Only the record's author may send it, for public records only. Rate-limited per DID.
Input application/json
| Name | Type | What it is |
|---|---|---|
urirequired | at-uri | The record just written, in your own repo. |
Output application/json
| Name | Type | What it is |
|---|---|---|
urirequired | at-uri | The record. |
cidrequired | cid | The version the platform fetched and verified. The decision is about this version. |
decisionrequired | string | valid means it counts. pending means nothing is wrong, but a claim it needs has not arrived yet. invalid means it does not count, for reason. |
reason | string | Why the decision is invalid. It names the lexicon problems, no public home, no lexicon for the collection, or the provenance or trust rule it fails. |
The decision is the one every read of the platform gives for that version. Errors InvalidRequest (400), AuthenticationRequired (401), NotAuthorized (403, not your record), RecordNotFound (404, the PDS does not hold it), RateLimitExceeded (429) and UnverifiedRecord (502, the proof did not verify; nothing was indexed). The full lexicon is at indexRecord.sync.draft.techne.pub.
put writes public records to your PDS, then sends this hint for each one. It answers invalid with the reason when the platform refused the record, else pending until the curated version lands ({ wait: ms }). A failed hint answers pending, because the relay brings the record anyway.
Write the record to your PDS first; techne.put uses com.atproto.repo.applyWrites. The Bearer token is your session, or an atproto service-auth JWT with lxm set to this method.