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.
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
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
Changes
No recorded changes to this operation across all 1 revision of this API.