--- title: "Updates a specific HostedNumberOrder." method: POST path: "/HostedNumbers/HostedNumberOrders/{Sid}" tags: ["PreviewHostedNumbersHostedNumberOrder"] --- # Updates a specific HostedNumberOrder. `POST /HostedNumbers/HostedNumberOrders/{Sid}` ## Request - Base URL: `https://preview.twilio.com` - URL: `https://preview.twilio.com/HostedNumbers/HostedNumberOrders/{Sid}` - Auth: HTTP basic Updates a specific HostedNumberOrder. ## Path parameters - `Sid` string, required ## Request body `application/x-www-form-urlencoded` - object - `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` string[]: Optional. A list of emails that LOA document for this HostedNumberOrder will be carbon copied to. - `Status` 'twilio-processing' | 'received' | 'pending-verification' | 'verified' | 'pending-loa' | 'carrier-processing' | 'testing' | 'completed' | 'failed' | 'action-required': 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](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/hosted-number-order-resource#status-values) section for more information on each of these statuses. - `VerificationCode` string: A verification code that is given to the user via a phone call to the phone number that is being hosted. - `VerificationType` 'phone-call' | 'phone-bill': The type of ownership verification required to move the number to a `verified` state. The verification methods 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. - `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. ## Response `200` OK - PreviewHostedNumbersHostedNumberOrder - `sid` string, nullable: A 34 character string that uniquely identifies this HostedNumberOrder. - `account_sid` string, nullable: A 34 character string that uniquely identifies the account. - `incoming_phone_number_sid` string, nullable: A 34 character string that uniquely identifies the [IncomingPhoneNumber](https://www.twilio.com/docs/phone-numbers/api/incomingphonenumber-resource) resource that represents the phone number being hosted. - `address_sid` string, nullable: A 34 character string that uniquely identifies the Address resource that represents the address of the owner of this phone number. - `signing_document_sid` string, nullable: A 34 character string that uniquely identifies the [Authorization Document](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/authorization-document-resource) the user needs to sign. - `phone_number` string, phone-number, nullable: Phone number to be hosted. This must be in [E.164](https://en.wikipedia.org/wiki/E.164) format, e.g., +16175551212 - `capabilities` object, nullable: Set of booleans describing the capabilities hosted on Twilio's platform. SMS is currently only supported. - `mms` boolean - `sms` boolean - `voice` boolean - `fax` boolean - `friendly_name` string, nullable: A 64 character string that is a human-readable text that describes this resource. - `unique_name` string, nullable: 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` 'twilio-processing' | 'received' | 'pending-verification' | 'verified' | 'pending-loa' | 'carrier-processing' | 'testing' | 'completed' | 'failed' | 'action-required': 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](https://www.twilio.com/docs/phone-numbers/hosted-numbers/hosted-numbers-api/hosted-number-order-resource#status-values) section for more information on each of these statuses. - `failure_reason` string, nullable: A message that explains why a hosted_number_order went to status "action-required" - `date_created` string, date-time, nullable: The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. - `date_updated` string, date-time, nullable: The date that this resource was updated, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. - `verification_attempts` integer: The number of attempts made to verify ownership of the phone number that is being hosted. - `email` string, nullable: Email of the owner of this phone number that is being hosted. - `cc_emails` string[], nullable: A list of emails that LOA document for this HostedNumberOrder will be carbon copied to. - `url` string, uri, nullable: The URL of this HostedNumberOrder. - `verification_type` 'phone-call' | 'phone-bill': The type of ownership verification required to move the number to a `verified` state. The verification methods are `phone-call` or `phone-bill`. - `verification_document_sid` string, nullable: A 34 character string that uniquely identifies the Identity Document resource that represents the document for verifying ownership of the number to be hosted. - `extension` string, nullable: 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. - `verification_code` string, nullable: A verification code provided in the response for a user to enter when they pick up the phone call. - `verification_call_sids` string[], nullable: A list of 34 character strings that are unique identifiers for the calls placed as part of ownership verification. ## Changes > 69 revisions in range; 49 not diffed. - **2022-08-04** `f637b0d2427b`: 1 breaking, 1 info - the `capabilities` response's property format changed from no format to `phone-number-capabilities` for status `200` - api operation id `UpdateHostedNumberOrder` removed and replaced with `UpdateHostedNumbersHostedNumberOrder` [Operation history](https://skmtc.dev/twilio/apis/twilio-preview/changes/HostedNumbers/HostedNumberOrders/:Sid/post.md) --- [API](https://skmtc.dev/twilio/apis/twilio-preview.md) - [All operations](https://skmtc.dev/twilio/apis/twilio-preview/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-preview/revisions/1d44f6bde1ff?raw)