B3 B3Os Webhooks

generated: '2026-07-18'
method: derived
source: openapi/b3-b3os-workflow-openapi.json
spec_type: Webhooks
note: >-
  B3OS publishes no AsyncAPI document, but the Workflow API exposes a first-class
  outbound-webhook surface with delivery tracking, replay/retry, and per-organization
  signing secrets. Captured as a webhook catalog (type: Webhooks). Never fabricated —
  every path below exists verbatim in the OpenAPI.
signing:
  mechanism: per-organization webhook secret
  operation: "GET /organizations/{orgId}/webhook-secret"
delivery_management:
  - method: GET
    path: "/v1/outbound-webhook/deliveries"
    summary: List outbound webhook deliveries
  - method: GET
    path: "/v1/outbound-webhook/deliveries/{id}"
    summary: Get outbound webhook delivery
  - method: POST
    path: "/v1/outbound-webhook/deliveries/{id}/replay"
    summary: Replay outbound webhook delivery
  - method: POST
    path: "/v1/outbound-webhook/deliveries/{id}/retry"
    summary: Retry outbound webhook delivery
webhook_events:
  - method: GET
    path: "/v1/webhook-events"
    summary: List webhook events
  - method: POST
    path: "/v1/webhook-events/{eventId}/replay"
    summary: Replay a webhook event
triggers:
  - method: GET
    path: "/v1/triggers"
    summary: List available workflow triggers
  - method: GET
    path: "/v1/triggers/{type}"
    summary: Get trigger type detail
  - method: GET
    path: "/v1/workflows/{id}/trigger-info"
    summary: Get workflow trigger info
integrations:
  - method: POST
    path: "/v1/orgs/{orgId}/integrations/webhook"
    summary: Register an inbound webhook integration