Org

Set the caller's own display name

Sets display_name on the calling principal (1–64 characters after trimming, no control characters) and returns the same body GET /agent/v1/whoami returns. Self-only: a grant key sets the name of the principal it acts for, never a name of its own. This name is what promotion credit (hand_to_member.credited_as), run402 up's room presence, and audit surfaces show for the principal; run402 init --name, run402 org whoami --set-name, and up's agent-principal-only default (RUN402_AGENT_NAME when the runtime declares one, else a specifically detected client: claude-code, codex, cursor, grok; nothing is written when nothing is known) all land here. Wallet principals are created unnamed: the gateway never seeds display_name from the wallet subject.

patch/agent/v1/me

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/agent/v1/me
  • Auth: one of:
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer
    • HTTP bearer

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Request body

display_namestring required

Example request

{
  "display_name": "Grok"
}

Response

The updated principal in the whoami body shape.

Changes

No recorded changes to this operation across all 1 revision of this API.