run402-com · Schema

BuzzHumanAdoptionOffer

Artificial IntelligenceInfrastructureBackendOpen SourceAgents

Properties

Name Type Description
buzz_human_adoption_offer_id string
org_id object
initiating_agent_principal_id string
identity_link_id string
expected_buzz_owner object
status string
offer_url stringnull
deployment_context object
current_buzz_human_adoption_id stringnull
completed_buzz_human_adoption objectnull
latest_attempt_receipt object
created_at string
updated_at string
completed_at stringnull
cancelled_at stringnull
ineligible_at stringnull
ineligible_reason stringnull
next_actions array
View JSON Schema on GitHub

JSON Schema

run402-com-buzz-human-adoption-offer-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/run402-com/json-schema/run402-com-buzz-human-adoption-offer-schema.json",
  "title": "BuzzHumanAdoptionOffer",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/run402-com-buzz-control-plane-api-openapi.yml#/components/schemas/BuzzHumanAdoptionOffer",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "buzz_human_adoption_offer_id",
    "org_id",
    "initiating_agent_principal_id",
    "identity_link_id",
    "expected_buzz_owner",
    "status",
    "offer_url",
    "deployment_context",
    "current_buzz_human_adoption_id",
    "completed_buzz_human_adoption",
    "latest_attempt_receipt",
    "created_at",
    "updated_at",
    "completed_at",
    "cancelled_at",
    "ineligible_at",
    "ineligible_reason",
    "next_actions"
  ],
  "properties": {
    "buzz_human_adoption_offer_id": {
      "type": "string",
      "pattern": "^buzzhao_[0-9a-f]{32}$"
    },
    "org_id": {
      "$ref": "#/$defs/BuzzOrgId"
    },
    "initiating_agent_principal_id": {
      "type": "string"
    },
    "identity_link_id": {
      "type": "string",
      "pattern": "^idlnk_[0-9a-f]{32}$"
    },
    "expected_buzz_owner": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "nostr_subject",
        "evidence",
        "authoritative_for_run402"
      ],
      "properties": {
        "nostr_subject": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "evidence": {
          "type": "string",
          "enum": [
            "nip_oa_owner_attestation"
          ]
        },
        "authoritative_for_run402": {
          "type": "boolean",
          "enum": [
            false
          ]
        }
      }
    },
    "status": {
      "type": "string",
      "enum": [
        "available",
        "completed",
        "cancelled",
        "ineligible"
      ]
    },
    "offer_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "deployment_context": {
      "allOf": [
        {
          "$ref": "#/$defs/BuzzHumanAdoptionDeploymentContext"
        }
      ]
    },
    "current_buzz_human_adoption_id": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^buzzha_[0-9a-f]{32}$"
    },
    "completed_buzz_human_adoption": {
      "type": [
        "object",
        "null"
      ]
    },
    "latest_attempt_receipt": {
      "$ref": "#/$defs/BuzzHumanAdoptionAttemptReceipt"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "completed_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "cancelled_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "ineligible_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "ineligible_reason": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "agent_inactive",
        "agent_not_sole_owner",
        "human_owner_exists",
        "identity_link_inactive",
        "owner_attestation_missing",
        "active_adoption_exists",
        "direct_adoption_pending",
        null
      ]
    },
    "next_actions": {
      "type": "array",
      "maxItems": 1,
      "items": {
        "$ref": "#/$defs/BuzzNextAction"
      }
    }
  },
  "$defs": {
    "BuzzHumanAdoptionAttemptReceipt": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "required": [
        "attempt_reference",
        "status",
        "issued_at",
        "expires_at",
        "expired_at",
        "cancelled_at",
        "activated_at",
        "diagnosis_code",
        "last_observed_stage",
        "last_trace_id",
        "milestones"
      ],
      "properties": {
        "attempt_reference": {
          "type": "string",
          "pattern": "^buzzha_[0-9a-f]{32}$"
        },
        "status": {
          "type": "string",
          "enum": [
            "pending",
            "active",
            "expired",
            "cancelled"
          ]
        },
        "issued_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "expires_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "expired_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "cancelled_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "activated_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "diagnosis_code": {
          "type": "string",
          "enum": [
            "COMPLETED",
            "COMPLETION_REJECTED",
            "CLIENT_OBSERVED_COMPLETION_ERROR",
            "ATTEMPT_CANCELLED",
            "EXPIRED_AFTER_PROOF_RECEIVED",
            "EXPIRED_AFTER_INVALID_CALLBACK",
            "EXPIRED_AFTER_INVALID_MANUAL_PROOF",
            "EXPIRED_AFTER_CLIENT_COMPLETION_ERROR",
            "EXPIRED_AFTER_BUZZ_OPEN_REQUESTED",
            "EXPIRED_WITHOUT_BUZZ_OPEN_OBSERVED",
            "PROOF_RECEIVED_COMPLETION_PENDING",
            "INVALID_CALLBACK_RETRY_AVAILABLE",
            "INVALID_MANUAL_PROOF_RETRY_AVAILABLE",
            "BUZZ_OPEN_REQUESTED_CALLBACK_PENDING",
            "AWAITING_BUZZ_OPEN"
          ]
        },
        "last_observed_stage": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_trace_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "milestones": {
          "type": "array",
          "maxItems": 32,
          "items": {
            "$ref": "#/$defs/BuzzHumanAdoptionAttemptReceiptMilestone"
          }
        }
      }
    },
    "BuzzHumanAdoptionAttemptReceiptMilestone": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "stage",
        "observed_at"
      ],
      "properties": {
        "stage": {
          "type": "string",
          "enum": [
            "attempt_created",
            "buzz_open_requested",
            "callback_received",
            "callback_invalid_observed",
            "manual_proof_submitted",
            "manual_proof_invalid_observed",
            "completion_error_observed",
            "completion_rejected",
            "completion_succeeded",
            "attempt_expired"
          ]
        },
        "observed_at": {
          "type": "string",
          "format": "date-time"
        },
        "trace_id": {
          "type": "string"
        },
        "result_code": {
          "type": "string"
        }
      }
    },
    "BuzzHumanAdoptionDeploymentContext": {
      "type": "object",
      "additionalProperties": false,
      "description": "Optional proof that the offer describes a real, currently-live deployment. All five fields are required together; no others are accepted. The gateway verifies project_id + release_id against the org's active release and live_url against its added subdomain, custom domain, or deployment host.",
      "required": [
        "project_id",
        "release_id",
        "live_url",
        "source_revision",
        "verified_at"
      ],
      "properties": {
        "project_id": {
          "type": "string"
        },
        "release_id": {
          "type": "string"
        },
        "live_url": {
          "type": "string",
          "format": "uri",
          "pattern": "^https://"
        },
        "source_revision": {
          "type": "string"
        },
        "verified_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "BuzzNextAction": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type",
        "auth",
        "why",
        "safe_to_auto_execute",
        "requires_approval",
        "destructive",
        "idempotent",
        "spend_impact"
      ],
      "properties": {
        "type": {
          "type": "string"
        },
        "method": {
          "type": "string",
          "enum": [
            "GET",
            "POST",
            "PATCH",
            "DELETE"
          ]
        },
        "path": {
          "type": "string"
        },
        "field": {
          "type": "string",
          "description": "Exact rejected request field or header when the repair is field-specific."
        },
        "auth": {
          "type": "string"
        },
        "why": {
          "type": "string"
        },
        "safe_to_auto_execute": {
          "type": "boolean"
        },
        "requires_approval": {
          "type": "boolean"
        },
        "destructive": {
          "type": "boolean"
        },
        "idempotent": {
          "type": "boolean"
        },
        "spend_impact": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "currency",
            "max_amount"
          ],
          "properties": {
            "currency": {
              "type": "string",
              "enum": [
                "USD"
              ]
            },
            "max_amount": {
              "type": "string",
              "enum": [
                "0"
              ]
            }
          }
        }
      }
    },
    "BuzzOrgId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "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."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/run402-com-buzz-human-adoption-offer"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.