Buzz Control Plane

Read an authorized Buzz human-adoption offer

Authorized only to the exact initiating agent SIWX authenticator or the target human/session lineage after an attempt exists. Unknown and unauthorized ids share the same 403 response.

get/buzz-human-adoption-offers/v1/{buzz_human_adoption_offer_id}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/buzz-human-adoption-offers/v1/{buzz_human_adoption_offer_id}
  • Auth: one of:
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer

Path parameters

buzz_human_adoption_offer_idstring required

Response

Authoritative converged offer state

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.