Buzz Control Plane

Pause an active route at match time

post/buzz-project-event-routes/v1/{buzz_project_event_route_id}/pause

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/buzz-project-event-routes/v1/{buzz_project_event_route_id}/pause
  • 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.

Response

Paused route; retained non-terminal deliveries freeze, and events occurring while paused are never retroactively delivered

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.