Buzz Control Plane

Activate through the invite front door: Run402 claims a one-use relay invite as the installation identity

A Buzz community owner or admin mints a one-use invite in Buzz Desktop and the Run402 org owner submits its link or code. Run402 claims it as the installation identity over the relay's released invite API (NIP-98 signed by that identity; the relay's join policy is accepted and recorded when advertised), verifies the current relay-signed NIP-43 kind-13534 membership snapshot lists the identity, probes NIP-OA support (bot_mode), and activates. No Nostr key leaves Buzz Desktop; there is no approval post. The invite is a one-use bearer artifact and is never echoed. Errors, each with one forced next action: BUZZ_INVITE_REQUIRED (422), BUZZ_INVITE_UNRECOGNIZED (422), BUZZ_INVITE_REFUSED (409), BUZZ_INVITE_CLAIM_UNAVAILABLE (503), BUZZ_INVITE_RATE_LIMITED (429).

post/buzz-community-installations/v1/{buzz_community_installation_id}/activate

Request

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

Path parameters

buzz_community_installation_idstring required

Headers

Idempotency-Keystring required

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

Request body

invitestring required

The one-use invite exactly as Buzz Desktop produced it: a bare code, an https://<relay>/invite/<code> link, or a buzz://join?relay=...&code=... link for this installation's relay.

Response

Active community installation

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.