Buzz Control Plane

Begin installation of Run402 into a Buzz community

post/buzz-community-installations/v1

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/buzz-community-installations/v1
  • Auth: one of:
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer

Headers

Idempotency-Keystring required

Stable visible-ASCII key. Exact retries return the original effective lifecycle resource.

Request body

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.

buzz_community_subjectstring required
buzz_community_authority_subjectstring

Response

Idempotent replay

buzz_community_installation_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.

buzz_community_subjectstring required
buzz_community_authority_subjectstring nullable

Optional and unverified since the invite front door: the relay, not a named authority, admits the installation identity.

relay_urlstring
relay_selfstring nullable
status'pending' | 'active' | 'expired' | 'revoked' required
membership_event_idstring nullable required

The relay-signed kind-13534 membership event that activated the installation.

bot_mode'attested' | 'installation_identity' nullable required

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.

notification_pubkeystring

Kept for older clients: the installation identity's pubkey.

descriptor_revisioninteger required
descriptor_hashstring nullable
default_for_enrollmentboolean required
policy_revisioninteger required
evidence_observed_atstring date-time nullable
issued_atstring date-time required
expires_atstring date-time required
activated_atstring date-time nullable
expired_atstring date-time nullable required
revoked_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required
driftobject[] required

Changes

No recorded changes to this operation across all 1 revision of this API.