Updates a specific HostedNumberOrder.
Updates a specific HostedNumberOrder.
Path parameters
-
A 34 character string that uniquely identifies this HostedNumberOrder.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^HR[0-9a-fA-F]{32}$
.
Body
-
A 64 character string that is a human readable text that describes this resource.
-
Provides a unique and addressable name to be assigned to this HostedNumberOrder, assigned by the developer, to be optionally used in addition to SID.
-
Email of the owner of this phone number that is being hosted.
-
Optional. A list of emails that LOA document for this HostedNumberOrder will be carbon copied to.
-
Status of this resource. It can hold one of the values: 1. Twilio Processing 2. Received, 3. Pending LOA, 4. Carrier Processing, 5. Completed, 6. Action Required, 7. Failed. See the HostedNumberOrders Status Values section for more information on each of these statuses.
Values are
received
,pending-verification
,verified
,pending-loa
,carrier-processing
,testing
,completed
,failed
, oraction-required
. -
A verification code that is given to the user via a phone call to the phone number that is being hosted.
-
The type of ownership verification required to move the number to a
verified
state. The verification methods arephone-call
orphone-bill
.Values are
phone-call
orphone-bill
. -
Optional. The unique sid identifier of the Identity Document that represents the document for verifying ownership of the number to be hosted. Required when VerificationType is phone-bill.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^RI[0-9a-fA-F]{32}$
. -
Digits to dial after connecting the verification call.
-
The number of seconds, between 0 and 60, to delay before initiating the verification call. Defaults to 0.
curl \
--request POST 'https://preview.twilio.com/HostedNumbers/HostedNumberOrders/{Sid}' \
--user "username:password" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data 'Email=test%2Bhosted%40twilio.com&Status=pending-loa&CcEmails=test1%40twilio.com&CcEmails=test2%40twilio.com&CallDelay=15&Extension=1234&UniqueName=new+unique+name&FriendlyName=new+friendly+name'
{"Email"=>"test+hosted@twilio.com", "Status"=>"pending-loa", "CcEmails"=>["test1@twilio.com", "test2@twilio.com"], "CallDelay"=>15, "Extension"=>"1234", "UniqueName"=>"new unique name", "FriendlyName"=>"new friendly name"}
{
"sid": "HRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://preview.twilio.com/HostedNumbers/HostedNumberOrders/HRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"email": "test+hosted@twilio.com",
"status": "pending-loa",
"cc_emails": [
"test1@twilio.com",
"test2@twilio.com"
],
"extension": "1234",
"call_delay": 15,
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"address_sid": "AD11111111111111111111111111111111",
"unique_name": "new unique name",
"capabilities": {
"sms": true,
"voice": false
},
"date_created": "2017-03-28T20:06:39Z",
"date_updated": "2017-03-28T20:06:39Z",
"phone_number": "+14153608311",
"friendly_name": "new friendly name",
"failure_reason": "",
"verification_code": "8794",
"verification_type": "phone-call",
"signing_document_sid": "PX11111111111111111111111111111111",
"verification_attempts": 1,
"verification_call_sids": [
"CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab"
],
"incoming_phone_number_sid": "PN11111111111111111111111111111111",
"verification_document_sid": null
}