Skip to main content

com.atproto.repo.putRecord

POST 
/xrpc/com.atproto.repo.putRecord

This endpoint is part of the atproto PDS repository management APIs. Requests usually require authentication (unlike the com.atproto.sync.* endpoints), and are made directly to the user's own PDS instance.

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

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

Request​

Body

required

    repo at-identifierrequired

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

    collection nsidrequired

    The NSID of the record collection.

    rkey stringrequired

    Possible values: <= 15 characters

    The Record Key.

    validate boolean

    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.

    record required
    swapRecord cid

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

    swapCommit cid

    Compare and swap with the previous commit by CID.

Responses​

OK

Schema

    uri at-urirequired
    cid cidrequired

    commit

    object

    cid cidrequired
    rev stringrequired
    validationStatus string

    Possible values: [valid, unknown]

Loading...