Updates a specific HostedNumberOrder.

POST /HostedNumbers/HostedNumberOrders/{Sid}

Updates a specific HostedNumberOrder.

Path parameters

  • Sid string Required

    A 34 character string that uniquely identifies this HostedNumberOrder.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^HR[0-9a-fA-F]{32}$.

application/x-www-form-urlencoded

Body

  • FriendlyName string

    A 64 character string that is a human readable text that describes this resource.

  • UniqueName string

    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 string

    Email of the owner of this phone number that is being hosted.

  • CcEmails array[string]

    Optional. A list of emails that LOA document for this HostedNumberOrder will be carbon copied to.

  • Status string

    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, or action-required.

  • VerificationCode string

    A verification code that is given to the user via a phone call to the phone number that is being hosted.

  • VerificationType string

    The type of ownership verification required to move the number to a verified state. The verification methods are phone-call or phone-bill.

    Values are phone-call or phone-bill.

  • VerificationDocumentSid string

    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 is 34. Format should match the following pattern: ^RI[0-9a-fA-F]{32}$.

  • Extension string

    Digits to dial after connecting the verification call.

  • CallDelay integer

    The number of seconds, between 0 and 60, to delay before initiating the verification call. Defaults to 0.

Responses

  • 200 application/json

    OK

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • sid string | null

      A 34 character string that uniquely identifies this HostedNumberOrder.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^HR[0-9a-fA-F]{32}$.

    • account_sid string | null

      A 34 character string that uniquely identifies the account.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • incoming_phone_number_sid string | null

      A 34 character string that uniquely identifies the IncomingPhoneNumber resource that represents the phone number being hosted.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^PN[0-9a-fA-F]{32}$.

    • address_sid string | null

      A 34 character string that uniquely identifies the Address resource that represents the address of the owner of this phone number.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AD[0-9a-fA-F]{32}$.

    • signing_document_sid string | null

      A 34 character string that uniquely identifies the Authorization Document the user needs to sign.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^PX[0-9a-fA-F]{32}$.

    • phone_number string(phone-number) | null

      Phone number to be hosted. This must be in E.164 format, e.g., +16175551212

    • capabilities object(phone-number-capabilities) | null

      Set of booleans describing the capabilities hosted on Twilio's platform. SMS is currently only supported.

      Hide capabilities attributes Show capabilities attributes object(phone-number-capabilities) | null
      • mms boolean
      • sms boolean
      • voice boolean
      • fax boolean
    • friendly_name string | null

      A 64 character string that is a human-readable text that describes this resource.

    • unique_name string | null

      Provides a unique and addressable name to be assigned to this HostedNumberOrder, assigned by the developer, to be optionally used in addition to SID.

    • status string

      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, or action-required.

    • failure_reason string | null

      A message that explains why a hosted_number_order went to status "action-required"

    • date_created string(date-time) | null

      The date this resource was created, given as GMT RFC 2822 format.

    • date_updated string(date-time) | null

      The date that this resource was updated, given as GMT RFC 2822 format.

    • verification_attempts integer

      The number of attempts made to verify ownership of the phone number that is being hosted.

      Default value is 0.

    • email string | null

      Email of the owner of this phone number that is being hosted.

    • cc_emails array[string] | null

      A list of emails that LOA document for this HostedNumberOrder will be carbon copied to.

    • url string(uri) | null

      The URL of this HostedNumberOrder.

    • verification_type string

      The type of ownership verification required to move the number to a verified state. The verification methods are phone-call or phone-bill.

      Values are phone-call or phone-bill.

    • verification_document_sid string | null

      A 34 character string that uniquely identifies the Identity Document resource that represents the document for verifying ownership of the number to be hosted.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RI[0-9a-fA-F]{32}$.

    • extension string | null

      A numerical extension to be used when making the ownership verification call.

    • call_delay integer

      A value between 0-30 specifying the number of seconds to delay initiating the ownership verification call.

      Default value is 0.

    • verification_code string | null

      A verification code provided in the response for a user to enter when they pick up the phone call.

    • verification_call_sids array[string] | null

      A list of 34 character strings that are unique identifiers for the calls placed as part of ownership verification.

POST /HostedNumbers/HostedNumberOrders/{Sid}
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'
Request example
{"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"}
Response examples (200)
{
  "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
}