com.atproto.repo.putRecord

Domain Index: atproto.com

Crawl History

#main - procedure

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

Query Parameters

No fields defined

Request Body

Content Type: application/json

Data Fields

Name Type Details
collection string (required)

The NSID of the record collection.

Syntax Format: nsid

record unknown (required)

The record to write.

Field can contain arbitrary JSON/CBOR object data
repo string (required)

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

Syntax Format: at-identifier

rkey string (required)

The Record Key.

Length in bytes (when UTF-8 encoded): 512 max

swapCommit string

Compare and swap with the previous commit by CID.

Syntax Format: cid

swapRecord string (nullable)

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

Syntax Format: cid

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.

Response Body

Content Type: application/json

Data Fields

Name Type Details
cid string (required)

Syntax Format: cid

commit ref

Reference: com.atproto.repo.defs#commitMeta

uri string (required)

Syntax Format: at-uri

validationStatus string

Known Values: valid, unknown,

Errors

Name Description
InvalidSwap