Rules
Update Rule (async)
Updates rule configuration. Returns 202 Accepted, propagates in 30-60 seconds.
Gradual Rollout Pattern
Test configuration changes with production traffic before full deployment.
Strategy: Gradually shift traffic to new Setting, monitor, increase to 100%.
Flow: 90/10 → 50/50 → 0/100 (rollback to 100/0 if issues)
During Propagation
During propagation (~30-60s), webhooks may use previous or updated config until change is active.
Use Cases
- Credential rotation: Verify new auth works before full cutover
- Timeout tuning: Test connection settings with real traffic
What Can Change
- friendlyName, description: Metadata
- settings: Traffic distribution (percentages must sum to 100)
- matchType + its companion value (prefix or value): changes the rule's match type and value together (async, same 30-60s propagation as any other patch). Returns 409 if the new match key collides with another Rule, same check POST runs on create. Patching a Rule to the match config it already has is not a collision.
patch/v1/Webhooks/Rules/{ruleId}
Request
- Base URLhttps://webhooks.twilio.com
- AuthHTTP basic
Headers
Idempotency-Keystring uuid
Idempotency key for mutation operations. Must be a UUIDv7 (other UUID versions are rejected with a 400).
Request body
Response
Rule update accepted
Example response
{
"operation": {
"retentionPeriod": "P7D"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.