Buzz Control Plane

Begin adoption of an agent-owned Run402 organization by its Buzz human owner

post/buzz-human-adoptions/v1

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/buzz-human-adoptions/v1
  • 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.

Idempotency-Keystring required

Stable visible-ASCII key. Exact retries return the original effective lifecycle resource.

Request body

org_idstring uuid required

A Run402 organization id, exactly as returned by GET /agent/v1/whoami, GET /orgs/v1 and GET /projects/v1. Buzz owns no organizations of its own.

identity_link_idstring required

Response

Idempotent replay

buzz_human_adoption_idstring required
buzz_human_adoption_offer_idstring nullable
org_idstring uuid required

A Run402 organization id, exactly as returned by GET /agent/v1/whoami, GET /orgs/v1 and GET /projects/v1. Buzz owns no organizations of its own.

identity_link_idstring
initiating_agent_identity_link_idstring required

Public attribution link held by the initiating agent; not organization authority.

human_identity_link_idstring nullable required

Public attribution link created or reused for the adopting human after completion; not organization authority.

status'pending' | 'completed' | 'expired' | 'cancelled' required
owner_proof_event_idstring nullable
adopting_human_principal_idstring nullable
target_human_principal_idstring nullable
membership_idstring nullable
issued_atstring date-time required
expires_atstring date-time required
consumed_atstring date-time nullable
activated_atstring date-time nullable
completed_atstring date-time nullable
expired_atstring date-time nullable required
cancelled_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required
driftobject[] required

Changes

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