Skip to main content
← Back to list
01Issue
FeatureShippedSwamp ClubPublic
Assigneesstack72

Relationships

↔ sibling #4551↔ sibling #4533↔ sibling #4515↔ sibling #4491↔ sibling #4448↔ sibling #4417↔ sibling #4386↔ sibling #4360↔ sibling #4358

#4556 Docs: webhook routes from reviewed route files (webhook-routes/)

Opened by zack · 11/9/2026· Shipped 11/10/2026

swamp-club#4547 lets swamp serve load webhook routes from YAML files in a repo directory, so a route is added through a reviewed PR instead of host configuration. The manual needs route-file content.

Pages

  • content/manual/how-to/set-up-webhooks.md: a section on adding a route through a route file: directory (default webhook-routes/), one route per file with the serve.yaml webhooks fields (route, workflow, secret, scheme, header, prefix, config), apply with swamp serve reload, delete the file to remove the route. Routes must be under /hooks/ with no empty, dot or dot-dot segments, and secrets must use the @vault= form.
  • content/manual/reference/swamp-serve.md: the --webhook-routes-dir option, the webhook-routes-dir serve.yaml key and the SWAMP_WEBHOOK_ROUTES_DIR variable; precedence (a serve.yaml or --webhook route on the same path wins, the file route is reported as shadowed); the file source in health output; what swamp serve check-config validates for route files (fields, route rule, secret form, clashes, shadowing; not vault lookups or extension resolution).

Points to state

  • Approving a route file approves its workflow, scheme and secret reference; runs are authorized as service:webhook like any other route.
  • Route files are never read from extension directories; extensions cannot register routes.
  • A bad route file is refused on its own and never stops serve or other routes.
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 10 MOREISSUE_LINKED+ 5 MOREREVIEW+ 6 MOREPR_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

11/10/2026, 7:10:28 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack7211/9/2026, 11:33:18 PM
stack72 linked sibling of #455111/9/2026, 11:33:49 PM
stack72 linked sibling of #453311/9/2026, 11:33:51 PM
stack72 linked sibling of #451511/9/2026, 11:33:54 PM
stack72 linked sibling of #449111/9/2026, 11:33:57 PM
stack72 linked sibling of #444811/9/2026, 11:34:00 PM
stack72 linked sibling of #441711/9/2026, 11:34:03 PM
stack72 linked sibling of #438611/9/2026, 11:34:06 PM
stack72 linked sibling of #436011/9/2026, 11:34:10 PM
stack72 linked sibling of #435811/9/2026, 11:34:13 PM

Sign in to post a ripple.