Update inbound routing policy
Updates one or more fields for an existing policy. If scope or target IDs change, PHONE_NUMBER requires phone_number_id, AGENT requires agent_id, and PARTNER clears both target IDs.
Authorizations
API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.
Path Parameters
Opaque policy ID.
Body
Patch a webhook-backed inbound routing policy. If scope or target IDs change, PHONE_NUMBER requires phone_number_id, AGENT requires agent_id, and PARTNER clears both target IDs.
Policy scope. Runtime resolution priority is PHONE_NUMBER, then AGENT, then PARTNER.
PHONE_NUMBER, AGENT, PARTNER PHONE_NUMBER target DID. Use only with scope PHONE_NUMBER.
AGENT target. Use only with scope AGENT.
Policy label used in partner admin tooling.
1 - 200When false, the policy is stored but not evaluated.
HTTPS endpoint that receives the inbound.route event.
Optional webhook signing secret. Write-only; null clears it.
Policy decision webhook timeout in milliseconds.
250 <= x <= 5000Fallback action when webhook fails.
ANSWER_WITH_AI, REJECT Optional allowlist for webhook response actions. Use null to clear and allow all.
Action values supported by inbound route policy responses.
ANSWER_WITH_AI, SELECT_AGENT, TRANSFER, REJECT