---
title: "Cancel a pending Buzz human adoption"
method: DELETE
path: "/buzz-human-adoptions/v1/{buzz_human_adoption_id}"
tags: ["Buzz Control Plane"]
---

# Cancel a pending Buzz human adoption

`DELETE /buzz-human-adoptions/v1/{buzz_human_adoption_id}`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/buzz-human-adoptions/v1/{buzz_human_adoption_id}`
- Auth: API key in header `SIGN-IN-WITH-X`

## Path parameters

- `buzz_human_adoption_id` string, required

## Headers

- `Idempotency-Key` string, required

## Response `200`

Retained cancelled adoption

- BuzzHumanAdoption
  - `buzz_human_adoption_id` string, required
  - `buzz_human_adoption_offer_id` string, nullable
  - `org_id` string, 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_id` string
  - `initiating_agent_identity_link_id` string, required: Public attribution link held by the initiating agent; not organization authority.
  - `human_identity_link_id` string, 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_content` BuzzHumanAdoptionOwnerProofContent: Exact public five-minute Buzz owner-consent challenge. Offer-backed attempts use the released browser_fragment_v1 callback; direct compatibility attempts use clipboard return.
    - `deep_link` string, required
    - `challenge_id` string, uuid, required
    - `nonce` string, required
    - `verification_code` string, required
    - `audience` 'buzz:nostr-identity', required
    - `action` 'bind_nostr_identity', required
    - `protocol` 'buzz-nostr-identity', required
    - `version` '1', required
    - `origin` 'https://console.run402.com', uri, required
    - `expires_at` string, date-time, required
    - `return` 'clipboard' | 'browser_fragment_v1', required
    - `callback_url` string, uri, nullable, required
  - `owner_proof_event_id` string, nullable
  - `adopting_human_principal_id` string, nullable
  - `target_human_principal_id` string, nullable
  - `membership_id` string, nullable
  - `authority_effects` object, nullable, required: Non-null after completed adoption. The ordinary membership (role owner) is the sole organization-authority effect; the public identity link and terminal consent receipt are independently revocable/retained resources.
    - `human_membership_role` 'owner', required
    - `initiating_agent_membership_changed` false, required
    - `organization_ownership_transferred` false, required
    - `projects_transferred` false, required
    - `credentials_shared` false, required
  - `issued_at` string, date-time, required
  - `expires_at` string, date-time, required
  - `consumed_at` string, date-time, nullable
  - `activated_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `expired_at` string, date-time, nullable, required
  - `cancelled_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `drift` object[], required
  - `next_actions` BuzzNextAction[], required
    - `type` string, required
    - `method` 'GET' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `field` string: Exact rejected request field or header when the repair is field-specific.
    - `auth` string, required
    - `why` string, required
    - `safe_to_auto_execute` boolean, required
    - `requires_approval` boolean, required
    - `destructive` boolean, required
    - `idempotent` boolean, required
    - `spend_impact` object, required
      - `currency` 'USD', required
      - `max_amount` '0', required

## Other responses

- `403`: Canonical Buzz control-plane error. Authorization is existence-obscuring; proof failures never consume a challenge or partially create authority.
- `409`: Canonical Buzz control-plane error. Authorization is existence-obscuring; proof failures never consume a challenge or partially create authority.

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)