run402-com · Schema

BuzzCommunityInstallation

Artificial IntelligenceInfrastructureBackendOpen SourceAgents

Properties

Name Type Description
buzz_community_installation_id string
org_id object
buzz_community_subject string
buzz_community_authority_subject stringnull Optional and unverified since the invite front door: the relay, not a named authority, admits the installation identity.
relay_url string
relay_self stringnull
status string
descriptor object
membership_event_id stringnull The relay-signed kind-13534 membership event that activated the installation.
bot_mode stringnull Probed at activation, never configured: attested means each routed project posts under its own NIP-OA-attested bot; installation_identity means the identity posts everything itself.
invite_claim objectnull
join_policy objectnull
installation_identity objectnull The one relay member Run402 holds for this community: its public subject only, never a secret.
notification_pubkey string Kept for older clients: the installation identity's pubkey.
descriptor_revision integer
descriptor_hash stringnull
default_for_enrollment boolean
enrollment_policy object
policy_revision integer
evidence_observed_at stringnull
issued_at string
expires_at string
activated_at stringnull
expired_at stringnull
revoked_at stringnull
created_at string
updated_at string
drift array
next_actions array
View JSON Schema on GitHub

JSON Schema

run402-com-buzz-community-installation-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/run402-com/json-schema/run402-com-buzz-community-installation-schema.json",
  "title": "BuzzCommunityInstallation",
  "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/BuzzCommunityInstallation",
  "type": "object",
  "required": [
    "buzz_community_installation_id",
    "org_id",
    "buzz_community_subject",
    "status",
    "descriptor_revision",
    "default_for_enrollment",
    "enrollment_policy",
    "policy_revision",
    "issued_at",
    "expires_at",
    "expired_at",
    "created_at",
    "updated_at",
    "drift",
    "next_actions",
    "membership_event_id",
    "bot_mode",
    "invite_claim",
    "join_policy",
    "installation_identity"
  ],
  "properties": {
    "buzz_community_installation_id": {
      "type": "string",
      "pattern": "^buzzci_[0-9a-f]{32}$"
    },
    "org_id": {
      "$ref": "#/$defs/BuzzOrgId"
    },
    "buzz_community_subject": {
      "type": "string"
    },
    "buzz_community_authority_subject": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional and unverified since the invite front door: the relay, not a named authority, admits the installation identity."
    },
    "relay_url": {
      "type": "string"
    },
    "relay_self": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "active",
        "expired",
        "revoked"
      ]
    },
    "descriptor": {
      "allOf": [
        {
          "$ref": "#/$defs/BuzzCommunityDescriptor"
        }
      ]
    },
    "membership_event_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "The relay-signed kind-13534 membership event that activated the installation."
    },
    "bot_mode": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "attested",
        "installation_identity",
        null
      ],
      "description": "Probed at activation, never configured: attested means each routed project posts under its own NIP-OA-attested bot; installation_identity means the identity posts everything itself."
    },
    "invite_claim": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "required": [
        "status",
        "claimed_at",
        "community_id",
        "host",
        "role"
      ],
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "joined",
            "already_member"
          ]
        },
        "claimed_at": {
          "type": "string",
          "format": "date-time"
        },
        "community_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "host": {
          "type": [
            "string",
            "null"
          ]
        },
        "role": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "join_policy": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "required": [
        "version",
        "age_attestation_required",
        "accepted_at",
        "accepted_by_principal_id"
      ],
      "properties": {
        "version": {
          "type": "string"
        },
        "age_attestation_required": {
          "type": "boolean"
        },
        "accepted_at": {
          "type": "string",
          "format": "date-time"
        },
        "accepted_by_principal_id": {
          "type": "string"
        }
      }
    },
    "installation_identity": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "required": [
        "pubkey",
        "signing_generation",
        "profile_state"
      ],
      "description": "The one relay member Run402 holds for this community: its public subject only, never a secret.",
      "properties": {
        "pubkey": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "signing_generation": {
          "type": "integer"
        },
        "profile_state": {
          "type": "string",
          "enum": [
            "pending",
            "published"
          ]
        }
      }
    },
    "notification_pubkey": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$",
      "description": "Kept for older clients: the installation identity's pubkey."
    },
    "descriptor_revision": {
      "type": "integer"
    },
    "descriptor_hash": {
      "type": [
        "string",
        "null"
      ]
    },
    "default_for_enrollment": {
      "type": "boolean"
    },
    "enrollment_policy": {
      "$ref": "#/$defs/BuzzEnrollmentPolicy"
    },
    "policy_revision": {
      "type": "integer"
    },
    "evidence_observed_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "issued_at": {
      "type": "string",
      "format": "date-time"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time"
    },
    "activated_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "expired_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "revoked_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "drift": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "next_actions": {
      "type": "array",
      "maxItems": 1,
      "items": {
        "$ref": "#/$defs/BuzzNextAction"
      }
    }
  },
  "$defs": {
    "BuzzCommunityDescriptor": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "api_origin",
        "buzz_community_installation_id",
        "buzz_community_subject",
        "content_hash",
        "default_for_enrollment",
        "descriptor_revision",
        "issued_at",
        "org_id",
        "provider",
        "safe_policy_summary",
        "status"
      ],
      "properties": {
        "api_origin": {
          "type": "string",
          "format": "uri"
        },
        "buzz_community_installation_id": {
          "type": "string",
          "pattern": "^buzzci_[0-9a-f]{32}$"
        },
        "buzz_community_subject": {
          "type": "string",
          "pattern": "^buzz:community:"
        },
        "content_hash": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "default_for_enrollment": {
          "type": "boolean"
        },
        "descriptor_revision": {
          "type": "integer",
          "minimum": 1
        },
        "issued_at": {
          "type": "string",
          "format": "date-time"
        },
        "org_id": {
          "$ref": "#/$defs/BuzzDescriptorOrgId"
        },
        "provider": {
          "type": "string",
          "enum": [
            "run402"
          ]
        },
        "safe_policy_summary": {
          "$ref": "#/$defs/BuzzSafePolicySummary"
        },
        "status": {
          "type": "string",
          "enum": [
            "active",
            "revoked"
          ]
        }
      }
    },
    "BuzzDescriptorOrgId": {
      "type": "string",
      "pattern": "^org_[0-9a-f]{32}$",
      "description": "The same Run402 organization id in its resource-qualified spelling. Used ONLY inside the community descriptor, which is content-hashed and published to the Buzz community where a bare UUID carries no type."
    },
    "BuzzEnrollmentPolicy": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "mode",
        "requires_current_community_membership"
      ],
      "properties": {
        "mode": {
          "type": "string",
          "enum": [
            "manual",
            "automatic"
          ]
        },
        "requires_current_community_membership": {
          "type": "boolean",
          "enum": [
            true
          ]
        },
        "allowed_capabilities": {
          "type": "array",
          "maxItems": 16,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "read",
              "deploy",
              "project:archives:export",
              "functions:write",
              "secrets:read",
              "secrets:write",
              "domains:write",
              "mailbox:write"
            ]
          }
        },
        "max_grant_ttl_seconds": {
          "type": "integer",
          "minimum": 300,
          "maximum": 2592000
        },
        "owner_attested_agents": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "developer",
            null
          ],
          "description": "Open the teammate door: an agent whose NIP-OA attestation is signed by a current community owner or admin joins the installed organization as a developer under its own principal (`POST …/teammates`). `null` or absent closes it. The only role representable is developer."
        }
      },
      "description": "Manual by default. Automatic mode requires both an explicit capability allowlist and finite TTL cap. Enrollment grants represent no payment, spend, owner, grant-key, org-membership, project-creation, or future-project authority; the separate teammate door (`owner_attested_agents`) is the one way an installation confers ordinary developer membership, and only on an agent vouched for by a community owner or admin."
    },
    "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."
    },
    "BuzzSafePolicySummary": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "mode",
        "requires_current_community_membership",
        "allowed_capabilities",
        "max_grant_ttl_seconds"
      ],
      "properties": {
        "mode": {
          "type": "string",
          "enum": [
            "manual",
            "automatic"
          ]
        },
        "requires_current_community_membership": {
          "type": "boolean",
          "enum": [
            true
          ]
        },
        "allowed_capabilities": {
          "type": [
            "array",
            "null"
          ],
          "maxItems": 16,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "read",
              "deploy",
              "project:archives:export",
              "functions:write",
              "secrets:read",
              "secrets:write",
              "domains:write",
              "mailbox:write"
            ]
          },
          "description": "Exact effective capability allowlist, or null when none is configured."
        },
        "max_grant_ttl_seconds": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 300,
          "maximum": 2592000,
          "description": "Exact effective enrollment grant TTL cap, or null when none is configured."
        },
        "owner_attested_agents": {
          "type": "string",
          "enum": [
            "developer"
          ],
          "description": "The teammate door. Present only when agents attested by a current community owner or admin may join the installed organization as developers (`POST …/teammates`); absent when the door is closed. Its presence changes the descriptor's canonical bytes and content hash."
        }
      }
    }
  }
}

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-community-installation"
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.