Skip to main content
The Settings section provides administrative configuration for the platform’s integrations, alerting, runtime behavior, and gateway infrastructure. These pages require the forge-admin role.

​
Webhooks

Create webhook subscriptions to push platform events to external systems (CI/CD pipelines, monitoring tools, custom integrations) in real time.
1

Configure endpoint

Enter the target URL (must accept POST with JSON body). Select which event types trigger the webhook — subscribe to individual events or entire categories.
2

Set signing secret

Optionally configure an HMAC signing secret. Each delivery includes a signature header your endpoint can use to verify the payload originated from Forge.
3

Enable and test

Toggle on. Use the test action to send a sample payload and verify your endpoint parses it correctly before enabling for production traffic.
Delivery behavior: Failed deliveries retry up to 3 times with exponential backoff. The delivery log shows each attempt with HTTP status, response time, and error detail. Pause, resume, or revoke subscriptions at any time.

​
Alert Rules

Configure threshold-based alerts beyond the automatic cost alerts.
FieldDescription
Alert typeDaily cost, cost per run, step failure rate, approval age, workflow duration
ThresholdNumeric trigger value with comparison operator
ChannelIn-app, Slack, or both
DimensionOptional scope to a specific gateway, agent, or workflow
EnabledToggle on/off without deleting the rule
Rules are evaluated continuously. When a threshold is crossed, the alert fires to the configured channel. View alert history and most recent trigger time from the rules table.

​
Feature Flags

Toggle platform capabilities on or off with immediate effect.
FieldDescription
KeyUnique identifier (e.g., enable-checkpoints)
ValueBoolean toggle
TargetingPercentage rollout, specific users, specific gateways
Target countHow many entities are currently affected
Feature flags are stored in Convex and take effect immediately across the platform. All changes are logged in the Audit Trail.
Flag changes are immediate and affect all active operations. Use caution when toggling flags that affect workflow execution or governance behavior.

​
Deployment Config

Platform-level configuration for capabilities and runtime behavior. Managed by governance-level permissions. Changes here affect how the entire platform operates — treat with the same care as infrastructure changes.

​
Gateway Management

Register and configure gateways from the Resources section.
ActionDescription
RegisterAdd a new gateway with Bridge URL, name, and configuration. Test the connection before saving.
ConfigureSet minimum trust levels, cost alert thresholds, and display order for existing gateways.
Rotate tokensRotate gateway authentication tokens with zero-downtime transition (old token remains valid during overlap).
CompareSide-by-side comparison of agent, skill, and model inventories across gateways — useful for identifying drift between environments.
Burgundy supports multiple registered gateways. A gateway selector lets you switch between them; the selection persists across sessions. All registry, dispatch, and Bridge operations scope to the currently selected gateway.