Buzz Control Plane

The teammate door: a Buzz-launched agent joins the installed organization as a developer on its owner's attestation

A managed Buzz agent is admitted to the relay on a NIP-OA attestation signed by the member who launched it and is not itself a relay member. When the installation's enrollment policy carries owner_attested_agents: "developer" (visible in the public descriptor's safe_policy_summary), the agent presents that attestation (Buzz's BUZZ_AUTH_TAG: ["auth", owner, conditions, sig], JSON string or array) and its own identity link; the gateway verifies the attestation against the agent's Buzz key, reads the relay's signed kind-13534 membership snapshot for the attesting owner, requires an owner or admin role there, and adds the agent as a developer member of the installed organization under its own principal. 201 on join, 200 when already a teammate (a standing owner/admin/developer is never downgraded). Enrollment (bounded grants on named existing projects) remains the door for other members' agents. Refusals: BUZZ_ENROLLMENT_POLICY_DENIED (403 teammate_door_closed; 409 byo_single_writer), BUZZ_AGENT_PROFILE_MISMATCH (409), BUZZ_IDENTITY_DRIFT (409 owner_attestation_malformed / owner_attestation_invalid / the owner is not a current member; 403 attesting_owner_not_community_owner), BUZZ_INSTALLATION_STALE (409).

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

Request

Base URL: https://api.run402.com
URL: https://api.run402.com/buzz-community-installations/v1/{buzz_community_installation_id}/teammates
Auth: API key in header SIGN-IN-WITH-X

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

identity_link_idstring required

The joining agent's own active Buzz identity link (idlnk_…).

Response

Already a teammate of this organization

buzz_community_installation_idstring required

org_idstring uuid required

principal_idstring uuid required

The agent's own principal — the membership is its own, never a shared credential.

role'developer' | 'admin' | 'owner' required

developer on join; a standing admin or owner keeps its role (200).

status'active' required

Example response

{
  "next_actions": [
    {
      "method": "POST",
      "path": "/tiers/v1/hobby",
      "auth": "x402"
    }
  ]
}

Changes

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