Buzz Control Plane

Create or reuse an inert Buzz human-adoption offer

The eligible founder-agent SIWX owner creates one durable chat-safe HTTPS offer page. No challenge, human principal, membership, credential, or authority is created by this operation.

post/buzz-human-adoption-offers/v1

Request

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

Existing offer reused

buzz_human_adoption_offer_idstring required
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.

initiating_agent_principal_idstring required
identity_link_idstring required
status'available' | 'completed' | 'cancelled' | 'ineligible' required
offer_urlstring uri nullable required
current_buzz_human_adoption_idstring nullable required
completed_buzz_human_adoptionobject nullable required
created_atstring date-time required
updated_atstring date-time required
completed_atstring date-time nullable required
cancelled_atstring date-time nullable required
ineligible_atstring date-time nullable required
ineligible_reason'agent_inactive' | 'agent_not_sole_owner' | 'human_owner_exists' | 'identity_link_inactive' | 'owner_attestation_missing' | 'active_adoption_exists' | 'direct_adoption_pending' nullable required

Changes

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