com.atproto.repo.deleteRecord Documentation (EN)

main procedure

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

Input

Encodingapplication/json

collection stringnsid Required

The NSID of the record collection.

repo stringat-identifier Required

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

rkey stringrecord-key Required

The Record Key.

swapCommit stringcid Optional

Compare and swap with the previous commit by CID.

swapRecord stringcid Optional

Compare and swap with the previous record by CID.

Output

Encodingapplication/json

commit refcom.atproto.repo.defs#commitMeta Optional

No description available.

Errors

InvalidSwap

Try It

Direct PDS XRPC methods (com.atproto.*) are disabled in Try It for security reasons.

These methods interact directly with Personal Data Servers and require careful handling. Use a dedicated client or CLI tool instead.

View raw schema

{
  "description": "Delete a repository record, or ensure it doesn't exist. Requires auth, implemented by PDS.",
  "errors": [
    {
      "name": "InvalidSwap"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "collection": {
          "description": "The NSID of the record collection.",
          "format": "nsid",
          "type": "string"
        },
        "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",
          "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.",
          "format": "cid",
          "type": "string"
        }
      },
      "required": [
        "repo",
        "collection",
        "rkey"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "commit": {
          "ref": "com.atproto.repo.defs#commitMeta",
          "type": "ref"
        }
      },
      "type": "object"
    }
  },
  "type": "procedure"
}