com.atproto.identity.updateHandle Documentation (EN)

main procedure

Updates the current account's handle. Verifies handle validity, and updates did:plc document if necessary. Implemented by PDS, and requires auth.

Input

Encodingapplication/json

handle stringhandle Required

The new handle.

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": "Updates the current account's handle. Verifies handle validity, and updates did:plc document if necessary. Implemented by PDS, and requires auth.",
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "handle": {
          "description": "The new handle.",
          "format": "handle",
          "type": "string"
        }
      },
      "required": [
        "handle"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}