v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-028581251.8 KB
com.atproto.repo

Write a repository record, creating or updating it as needed. Requires auth, implemented by PDS.

post/xrpc/com.atproto.repo.putRecord

Request body

repostring at-identifier required

The handle or DID of the repo (aka, current account).

rkeystring record-key required

The Record Key.

{"stackTrail":"paths:/xrpc/com.atproto.repo.putRecord:post:requestBody:content:application/json:schema:properties:record","oasType":"schema","type":"unknown","description":"The record to write."}
validateboolean

Can be set to 'false' to skip Lexicon schema validation of record data, 'true' to require it, or leave unset to validate only for known Lexicons.

collectionstring nsid required

The NSID of the record collection.

swapCommitstring cid

Compare and swap with the previous commit by CID.

swapRecordstring cid

Compare and swap with the previous record by CID. WARNING: nullable and optional field; may cause problems with golang implementation

Response

Success

cidstring cid required
uristring uri required
validationStatusstring