Skip to navigation
REST APIPolicies

Update a policy

View as Markdown

Change any subset of a policy’s fields. entries, when present, replaces the whole list of allowed callers; to add or remove a few, use Add policy entries and Remove policy entries instead. Changes apply to the next inbound call, never to one already in progress.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Path parameters

idstringRequired

Request

This endpoint expects an object.
namestringOptional1-60 characters
scopeenumOptional
Allowed values:
numberIdslist of stringsOptional

Replaces the covered numbers. Required, and non-empty, when changing scope to numbers.

enabledbooleanOptional
entrieslist of objectsOptional
Replaces the whole list of allowed callers.

Response

The updated policy, with its entries.
policyobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error