Skip to content

Write a record that stays on this node instead of the caller's repo, such as its configuration for this node. Shaped like com.atproto.repo.putRecord.

POST
/xrpc/place.stream.local.putRecord
curl --request POST \
--url https://example.com/xrpc/place.stream.local.putRecord \
--header 'Content-Type: application/json' \
--data '{ "repo": "example", "collection": "example", "rkey": "example", "record": "example" }'
Media typeapplication/json
object
repo
required

The caller’s DID; a node keeps local records for their own author only.

string format: did
collection
required

One of the collections this node keeps locally.

string format: nsid
rkey
required
string format: record-key
<= 512 characters
record
required

Example generated

{
"repo": "example",
"collection": "example",
"rkey": "example",
"record": "example"
}

Success

Media typeapplication/json
object
uri
required
string format: uri
cid
required
string format: cid

Example generated

{
"uri": "https://example.com",
"cid": "example"
}

Bad Request

Media typeapplication/json
object
error
required
One of:
string
Allowed value: InvalidCollection
message
required
string

Example

{
"error": "InvalidCollection"
}