Skip to main content

Procedure: Create a Record

The simplest write: take the request body, save it as a record, and return the URI.

Lexicon type: procedure

function handle()
  local r = Record(collection, input)
  r:save()
  return { uri = r._uri, cid = r._cid }
end

How it works​

  1. Create a new Record instance from the target collection, populated with the fields from the request body.
  2. Call r:save(), which creates the record on the caller's PDS and indexes it locally.
  3. Return the AT URI and CID of the newly created record.

Usage​

curl -X POST http://localhost:3000/xrpc/xyz.statusphere.createRecord \
  -H "X-Client-Key: $CLIENT_KEY" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Hello world", "createdAt": "2025-01-01T00:00:00Z" }'

Use case​

This is the simplest possible write procedure. It works well when the client is responsible for populating all record fields and no server-side validation or transformation is needed.