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 URL
    https://webhooks.twilio.com
  • Auth
    HTTP basic

Headers

Idempotency-Keystring uuid

Idempotency key for mutation operations. Must be a UUIDv7 (other UUID versions are rejected with a 400).

Request body

OR
OR
OR

Response

Rule update accepted

Example response

{
  "operation": {
    "retentionPeriod": "P7D"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.