Update Phone Delivery Settings (Twilio)
PUT {{apiPath}}/environments/{{envID}}/notificationsSettings/phoneDeliverySettings/{{phoneDeliverySettingsID}}
The PUT /environments/{{envID}}/notificationsSettings/phoneDeliverySettings/{{phoneDeliverySettingsID}}
endpoint updates the specified custom Twilio phone delivery settings in a specified environment. Note the value of CUSTOM_TWILIO
assignmed to provider
in the request body.
Prerequisites
- See Notifications and Phone Delivery Settings for important overview information.
Property | Type | Required? |
---|---|---|
id | String | Required |
numbers | Array | Required |
provider | String | Required |
sid | String | Required |
See the Phone delivery settings data models for full property descriptions.
Request Body
{"id"=>"updatedTwilioPhoneDeliverySettingsId", "sid"=>"updatedSid", "provider"=>"CUSTOM_TWILIO", "numbers"=>[{"type"=>"SHORT_CODE", "capabilities"=>["SMS"], "selected"=>true, "available"=>true, "number"=>"894546"}, {"type"=>"SHORT_CODE", "capabilities"=>["SMS"], "selected"=>false, "available"=>true, "number"=>"894545", "supportedCountries"=>["CA"]}, {"type"=>"TOLL_FREE", "capabilities"=>["SMS", "VOICE"], "selected"=>true, "available"=>true, "number"=>"+18544440099", "supportedCountries"=>["US", "CA"]}, {"type"=>"TOLL_FREE", "capabilities"=>["SMS", "VOICE"], "selected"=>false, "available"=>true, "number"=>"+18544440098", "supportedCountries"=>["ALL"]}, {"type"=>"PHONE_NUMBER", "capabilities"=>["SMS", "VOICE"], "selected"=>true, "available"=>true, "number"=>"+172544440091"}, {"type"=>"PHONE_NUMBER", "capabilities"=>["SMS", "VOICE"], "selected"=>true, "available"=>true, "number"=>"+972544440099"}]}
RESPONSES
status: OK
{"_links":{"self":{"href":"http://api.pingone.com/environments/someEnvId/notificationsSettings/phoneDeliverySettings/2c39f0c2-5e58-42c6-8561-926b1c1e6028"},"environment":{"href":"http://api.pingone.com/environments/someEnvId/notificationsSettings"}},"id":"2c39f0c2-5e58-42c6-8561-926b1c1e6028","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"createdAt":"2020-05-19T10:25:23.319Z","updatedAt":"2020-05-19T10:25:23.319Z","sid":"d253292c-8740-4338-b886-17678bcbe6cc","numbers":[{"type":"PHONE_NUMBER","selected":false,"available":true,"createdAt":"2020-05-19T10:25:23.828Z","number":"+12024706245","capabilities":["SMS","VOICE"]},{"type":"PHONE_NUMBER","selected":false,"available":true,"createdAt":"2020-05-19T10:25:23.828Z","number":"+13462445724","capabilities":["SMS","VOICE"]},{"type":"TOLL_FREE","selected":false,"available":true,"createdAt":"2020-05-19T10:25:23.828Z","number":"+18449840672","capabilities":["SMS","VOICE"],"supportedCountries":["US","CA"]},{"type":"PHONE_NUMBER","selected":false,"available":true,"createdAt":"2020-05-19T10:25:23.828Z","number":"+13025817557","capabilities":["SMS","VOICE"]},{"type":"PHONE_NUMBER","selected":false,"available":true,"createdAt":"2020-05-19T10:25:23.828Z","number":"+972521209508","capabilities":["SMS","VOICE"]},{"type":"PHONE_NUMBER","selected":false,"available":true,"createdAt":"2020-05-19T10:25:23.828Z","number":"+61488846054","capabilities":["SMS","VOICE"]},{"type":"PHONE_NUMBER","selected":false,"available":true,"createdAt":"2020-05-19T10:25:23.828Z","number":"+19182157058","capabilities":["SMS","VOICE"]}],"provider":"BYO_TWILIO"}