Org

Adopt a wallet-owned org (first-class-orgs, Phase 1.5)

Become the OWNER of an org currently owned by your wallet's agent principal — an ownership transfer on org memberships, not a credential link. DUAL PROOF: the control-plane session (request auth) + a fresh action-bound SIWX signature from the wallet sent as the SIGN-IN-WITH-X header (carrying the challenge nonce). The wallet authenticator stays on the agent; the agent is downgraded owner→developer. If the wallet's agent owns more than one org, returns { status: 'select_org', selectable_orgs } until org_id is chosen.

post/orgs/v1/adopt

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/orgs/v1/adopt
  • Auth: API key in header SIGN-IN-WITH-X

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

org_idstring uuid

Required only when the wallet's agent owns more than one adoptable org.

display_namestring nullable

Optional label to set on the adopted org.

Response

Adopted, or a select_org prompt for a multi-org wallet

status'adopted' | 'select_org'
org_idstring uuid
display_namestring nullable
rolestring
already_ownedboolean
selectable_orgsobject[]

Changes

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