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 |
JSON Schema
{
"$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.
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.