Org

Resolve the caller's control-plane principal, memberships, and Buzz lifecycle state

SIWX, a control-plane session, or a scoped grant key bearer authenticates the caller and returns the resolved principal, active org memberships, and independent Buzz adoption/installation/enrollment eligibility and drift. A wallet and a Buzz proof are authenticators or attribution evidence, never owners by themselves. A grant key resolves to its own subject principal (typically with no memberships of its own, since a grant key acts via a project_grant rather than membership) — resolving your own identity actuates and leaks nothing beyond it, so this is grant-key-capable the same way the cold-restart-recovery POST /projects/v1/:project_id/tokens is.

get/agent/v1/whoami

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/agent/v1/whoami
  • 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.

Response

Resolved principal + memberships

principalobject nullable required
authenticator_idstring nullable required

Legacy sibling retained unchanged; equals active_authenticator.authenticator_id when present.

Changes

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