Enable emergency for a phone number

curl --location --request POST '/phone_numbers//actions/enable_emergency' \ --header 'Content-Type: application/json' \ --data-raw '{ "emergency_address_id": "53829456729313", "emergency_enabled": true }'

{ "data": { "call_forwarding": { "call_forwarding_enabled": true, "forwarding_type": "always", "forwards_to": "+13035559123" }, "call_recording": { "inbound_call_recording_channels": "single", "inbound_call_recording_enabled": true, "inbound_call_recording_format": "wav" }, "cnam_listing": { "cnam_listing_details": "example", "cnam_listing_enabled": true }, "connection_id": "1d0e6cb8-8668-462e-94c6-49ae0f0ed48b", "customer_reference": "customer-reference", "emergency": { "emergency_address_id": "1315261609962112019", "emergency_enabled": true, "emergency_status": "active" }, "id": "1293384261075731499", "inbound_call_screening": "disabled", "media_features": { "accept_any_rtp_packets_enabled": true, "rtp_auto_adjust_enabled": true, "t38_fax_gateway_enabled": true }, "record_type": "voice_settings", "tech_prefix_enabled": false, "translated_number": "+13035559999", "usage_payment_method": "pay-per-minute" } }

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

string <int64>

required

Identifies the resource.

Example:

1293384261075731499

Body Params application/json

emergency_address_id

string <int64>

required

Identifies the address to be used with emergency services.

emergency_enabled

boolean

required

Indicates whether to enable emergency services on this number.

Examples

Responses

🟢200OK

application/json

Phone number emergency enabled.

Body

data

object (PhoneNumberWithVoiceSettings)

optional

Example:

{"call_forwarding":{"call_forwarding_enabled":true,"forwarding_type":"always","forwards_to":"+13035559123"},"call_recording":{"inbound_call_recording_channels":"single","inbound_call_recording_enabled":true,"inbound_call_recording_format":"wav"},"cnam_listing":{"cnam_listing_details":"example","cnam_listing_enabled":true},"connection_id":"1d0e6cb8-8668-462e-94c6-49ae0f0ed48b","customer_reference":"customer-reference","emergency":{"emergency_address_id":"1315261609962112019","emergency_enabled":true,"emergency_status":"active"},"id":"1293384261075731499","inbound_call_screening":"disabled","media_features":{"accept_any_rtp_packets_enabled":true,"rtp_auto_adjust_enabled":true,"t38_fax_gateway_enabled":true},"record_type":"voice_settings","tech_prefix_enabled":false,"translated_number":"+13035559999","usage_payment_method":"pay-per-minute"}

call_forwarding

object (CallForwarding)

optional

The call forwarding settings for a phone number.

Example:

{"call_forwarding_enabled":true,"forwarding_type":"always","forwards_to":"+13035559123"}

call_recording

object (CallRecording)

optional

The call recording settings for a phone number.

Example:

{"inbound_call_recording_channels":"single","inbound_call_recording_enabled":true,"inbound_call_recording_format":"wav"}

cnam_listing

object (CnamListing)

optional

The CNAM listing settings for a phone number.

Example:

{"cnam_listing_details":"example","cnam_listing_enabled":true}

connection_id

string

optional

Identifies the connection associated with this phone number.

Example:

1d0e6cb8-8668-462e-94c6-49ae0f0ed48b

customer_reference

string

optional

A customer reference string for customer look ups.

Example:

MY REF 001

emergency

object (EmergencySettings)

optional

The emergency services settings for a phone number.

Example:

{"emergency_address_id":"1315261609962112019","emergency_enabled":true,"emergency_status":"active"}

string

read-onlyoptional

Identifies the type of resource.

Example:

1293384261075731499

inbound_call_screening

enum<string>

optional

The inbound_call_screening setting is a phone number configuration option variable that allows users to configure their settings to block or flag fraudulent calls. It can be set to disabled, reject_calls, or flag_calls. This feature has an additional per-number monthly cost associated with it.

Allowed values:

disabledreject_callsflag_calls

Default:

disabled

media_features

object (MediaFeatures)

optional

The media features settings for a phone number.

Example:

{"accept_any_rtp_packets_enabled":true,"rtp_auto_adjust_enabled":true,"t38_fax_gateway_enabled":true}

phone_number

string

read-onlyoptional

The phone number in +E164 format.

Example:

+13035551234

record_type

string

read-onlyoptional

Identifies the type of the resource.

Example:

voice_settings

tech_prefix_enabled

boolean

optional

Controls whether a tech prefix is enabled for this phone number.

Default:

false

Example:

false

translated_number

string

optional

This field allows you to rewrite the destination number of an inbound call before the call is routed to you. The value of this field may be any alphanumeric value, and the value will replace the number originally dialed.

Default:

Example:

+13035559999

usage_payment_method

enum<string>

optional

Controls whether a number is billed per minute or uses your concurrent channels.

Allowed values:

pay-per-minutechannel

Default:

pay-per-minute

Example:

pay-per-minute

🟢202Accepted

🔴500Server Error