Update webhook subscription
PATCH
/v1/admin/webhooks/{subscription_id}
Partial update — only provided fields are modified.
COMMON OPERATIONS: - Re-enable a DISABLED subscription: set status to ACTIVE (resets consecutive_failures) - Pause delivery: set status to PAUSED - Rotate signing secret: provide new signing_secret value - Change event types: provide new event_types array (replaces, does not merge)
Authorizations
AdminKeyAuth
Administrative API key with full system access
Type
API Key (header: X-Admin-API-Key)
Parameters
Path Parameters
subscription_id*
Type
Requiredstring
Request Body
application/json
JSON "name": "string", "description": "string", "url": "string", "event_types": [ "string" ], "event_categories": [ "string" ], "scope_filter": "string", "thresholds": { "budget_utilization": [ 0 ], "burn_rate_multiplier": 3, "burn_rate_window_seconds": 300, "denial_rate_threshold": 0.1, "expiry_rate_threshold": 0.05, "auth_failure_rate_threshold": 0.1, "rate_window_seconds": 300 }, "signing_secret": "string", "headers": { "additionalProperties": "string" }, "retry_policy": { "max_retries": 5, "initial_delay_ms": 1000, "backoff_multiplier": 2, "max_delay_ms": 60000 }, "disable_after_failures": 0, "status": "string", "metadata": { "additionalProperties": "string" }
{
}
Responses
Subscription updated
application/json
JSON "subscription_id": "string", "tenant_id": "string", "name": "string", "description": "string", "url": "string", "event_types": [ "string" ], "event_categories": [ "string" ], "scope_filter": "string", "thresholds": { "budget_utilization": [ 0 ], "burn_rate_multiplier": 3, "burn_rate_window_seconds": 300, "denial_rate_threshold": 0.1, "expiry_rate_threshold": 0.05, "auth_failure_rate_threshold": 0.1, "rate_window_seconds": 300 }, "signing_secret": "string", "headers": { "additionalProperties": "string" }, "status": "string", "retry_policy": { "max_retries": 5, "initial_delay_ms": 1000, "backoff_multiplier": 2, "max_delay_ms": 60000 }, "disable_after_failures": 10, "consecutive_failures": 0, "created_at": "string", "updated_at": "string", "last_triggered_at": "string", "last_success_at": "string", "last_failure_at": "string", "metadata": { "additionalProperties": "string" }
{
}