com.atproto.repo.createRecord

Create a single new repository record. Requires auth, implemented by PDS.

Repository @atproto-lexicons.bsky.social did:plc:6msi3pj7krzih5qxqtryxlzw namespace authority

Details · procedure

Kind	procedure
Authority	repo.atproto.com
Indexed	265d ago · 2026-02-18

Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

collection

requiredstring · nsid

The NSID of the record collection.

record

requiredunknown

The record itself. Must contain a $type field.

repo

requiredstring · at-identifier

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

rkey

string · record-key

The Record Key.

maxLength: 512

swapCommit

string · cid

Compare and swap with the previous commit by 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.

Output

application/json

cid

requiredstring · cid

commit

ref

Reference

com.atproto.repo.defs#commitMeta

uri

requiredstring · at-uri

validationStatus

string

knownValues: valid | unknown

Errors

InvalidSwap

Indicates that 'swapCommit' didn't match current repo commit.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

com.atproto.repo.putRecord
procedure

Write a repository record, creating or updating it as needed. Requires auth, implemented by PDS.
com.atproto.repo.applyWrites
procedure

Apply a batch transaction of repository creates, updates, and deletes. Requires auth, implemented by PDS.
ooo.bsky.hds.createRecord
procedure
ooo.bsky.hds.putRecord
procedure
com.atproto.repo.deleteRecord
procedure

Delete a repository record, or ensure it doesn't exist. Requires auth, implemented by PDS.