Buzz Control Plane

Update route name, channel, project scope, or filters with optimistic revision

patch/buzz-project-event-routes/v1/{buzz_project_event_route_id}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/buzz-project-event-routes/v1/{buzz_project_event_route_id}
  • Auth: one of:
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer

Path parameters

buzz_project_event_route_idstring required

Headers

Idempotency-Keystring required

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

Request body

expected_revisioninteger required

The route's current revision; a stale value fails 409 BUZZ_ROUTE_REVISION_STALE without mutation.

route_namestring
buzz_channel_idstring

Changing the destination channel re-verifies the relay's notification capability.

project_idsstring[]
event_typesstring[] nullable
event_classesstring[] nullable
include_org_eventsboolean
on_call_buzz_pubkeystring nullable

Set the agent this route pages on a crash or platform incident; null clears it (pages nobody).

on_call_display_namestring nullable

The name the page addresses the on-call agent by. Omitted when a NEW pubkey is set: resolved from its Buzz profile; null clears it (tag-only page).

project_scope'listed' | 'org'

Switch the route between its explicit project list and the whole organization. Switching to listed keeps the stored list and requires at least one project (422 BUZZ_ROUTE_SCOPE_INVALID otherwise).

Response

Updated route at the next revision

buzz_project_event_route_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_installation_idstring required
route_namestring required
buzz_channel_idstring required
project_idsstring[] required
event_typesstring[] nullable required

null routes every registered routable type (never an implicit []).

event_classesstring[] nullable required
include_org_eventsboolean
on_call_buzz_pubkeystring nullable

The Buzz agent a crash or platform incident on this route pages (64-hex pubkey), or null.

on_call_display_namestring nullable

The name the page addresses that agent by (@<name> please investigate:), or null for a tag-only page.

project_scope'listed' | 'org'

listed: only project_ids are routed. org: every project the organization owns, present and future.

status'pending_authorization' | 'active' | 'paused' | 'revoked' required
pause_reason'owner' | 'delivery_failures' nullable required
paused_atstring date-time nullable required
revisioninteger required
start_after_event_idinteger required

The project-events outbox floor captured at creation: the consumer never delivers an event that predates the route (start_from: now).

consecutive_hard_failuresinteger required

Consecutive hard relay-publish failures; crossing the bound auto-pauses the route with pause_reason delivery_failures.

notification_principal_idstring required
notification_pubkeystring required
signing_generationinteger required
bot_mode'attested' | 'installation_identity' nullable required

The installation's probed bot mode; attested means each project posts as its own bot.

created_atstring date-time required
updated_atstring date-time required
revoked_atstring date-time nullable required

Changes

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