com.atproto.repo.putRecord
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "Write a repository record, creating or updating it as needed. Requires auth, implemented by PDS.",
"errors": [
{
"name": "InvalidSwap"
}
],
"input": {
"encoding": "application/json",
"schema": {
"nullable": [
"swapRecord"
],
"properties": {
"collection": {
"description": "The NSID of the record collection.",
"format": "nsid",
"type": "string"
},
"record": {
"description": "The record to write.",
"type": "unknown"
},
"repo": {
"description": "The handle or DID of the repo (aka, current account).",
"format": "at-identifier",
"type": "string"
},
"rkey": {
"description": "The Record Key.",
"format": "record-key",
"maxLength": 512,
"type": "string"
},
"swapCommit": {
"description": "Compare and swap with the previous commit by CID.",
"format": "cid",
"type": "string"
},
"swapRecord": {
"description": "Compare and swap with the previous record by CID. WARNING: nullable and optional field; may cause problems with golang implementation",
"format": "cid",
"type": "string"
},
"validate": {
"description": "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.",
"type": "boolean"
}
},
"required": [
"repo",
"collection",
"rkey",
"record"
],
"type": "object"
}
},
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cid": {
"format": "cid",
"type": "string"
},
"commit": {
"ref": "com.atproto.repo.defs#commitMeta",
"type": "ref"
},
"uri": {
"format": "at-uri",
"type": "string"
},
"validationStatus": {
"knownValues": [
"valid",
"unknown"
],
"type": "string"
}
},
"required": [
"uri",
"cid"
],
"type": "object"
}
},
"type": "procedure"
}
},
"id": "com.atproto.repo.putRecord",
"lexicon": 1
}
Metadata
- DID
-
did:plc:6msi3pj7krzih5qxqtryxlzw - CID
-
bafyreigevzo2cypxpaj5re2u35so36df4rkgx6oh4zpi4zwicfvzqfdqpa - Indexed At
- 2026-02-18 18:57 UTC
- AT-URI
-
at://did:plc:6msi3pj7krzih5qxqtryxlzw/com.atproto.lexicon.schema/com.atproto.repo.putRecord
Referenced Schemas (1)
Similar Lexicons
Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
com.atproto.repo.createRecord procedure
Create a single new repository record. 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.putRecord procedure
-
com.atproto.repo.deleteRecord procedure
Delete a repository record, or ensure it doesn't exist. Requires auth, implemented by PDS.
-
rsvp.atmo.space.putRecord procedure
Write a record into a space. The author is always the JWT issuer. If rkey is omitted, a TID is generated.