TWtwilio
TrunkingV1Trunk

Changed on
post/v1/Trunks/{Sid}

Request

  • Base URL
    https://trunking.twilio.com
  • URL
    https://trunking.twilio.com/v1/Trunks/{Sid}
  • Auth
    HTTP basic

Path parameters

Sidstring required

The unique string that we created to identify the OriginationUrl resource to update.

Request body application/x-www-form-urlencoded

FriendlyNamestring

A descriptive string that you create to describe the resource. It can be up to 64 characters long.

DomainNamestring

The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and - and must end with pstn.twilio.com. See Termination Settings for more information.

DisasterRecoveryUrlstring uri

The URL we should call using the disaster_recovery_method if an error occurs while sending SIP traffic towards the configured Origination URL. We retrieve TwiML from the URL and execute the instructions like any other normal TwiML call. See Disaster Recovery for more information.

DisasterRecoveryMethod'GET' | 'POST' http-method

The HTTP method we should use to call the disaster_recovery_url. Can be: GET or POST.

TransferMode'disable-all' | 'enable-all' | 'sip-only'

The call transfer settings for the trunk. Can be: enable-all, sip-only and disable-all. See Transfer for more information.

Secureboolean

Whether Secure Trunking is enabled for the trunk. If enabled, all calls going through the trunk will be secure using SRTP for media and TLS for signaling. If disabled, then RTP will be used for media. See Secure Trunking for more information.

CnamLookupEnabledboolean

Whether Caller ID Name (CNAM) lookup should be enabled for the trunk. If enabled, all inbound calls to the SIP Trunk from the United States and Canada automatically perform a CNAM Lookup and display Caller ID data on your phone. See CNAM Lookups for more information.

TransferCallerId'from-transferee' | 'from-transferor'

Caller Id for transfer target. Can be: from-transferee (default) or from-transferor.

Response

OK

account_sidstring nullable

The SID of the Account that created the Trunk resource.

domain_namestring nullable

The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and - and must end with pstn.twilio.com. See Termination Settings for more information.

disaster_recovery_method'GET' | 'POST' http-method nullable

The HTTP method we use to call the disaster_recovery_url. Can be: GET or POST.

disaster_recovery_urlstring uri nullable

The URL we call using the disaster_recovery_method if an error occurs while sending SIP traffic towards the configured Origination URL. We retrieve TwiML from this URL and execute the instructions like any other normal TwiML call. See Disaster Recovery for more information.

friendly_namestring nullable

The string that you assigned to describe the resource.

secureboolean nullable

Whether Secure Trunking is enabled for the trunk. If enabled, all calls going through the trunk will be secure using SRTP for media and TLS for signaling. If disabled, then RTP will be used for media. See Secure Trunking for more information.

recordingunknown
transfer_mode'disable-all' | 'enable-all' | 'sip-only'

The call transfer settings for the trunk. Can be: enable-all, sip-only and disable-all. See Transfer for more information.

transfer_caller_id'from-transferee' | 'from-transferor'

Caller Id for transfer target. Can be: from-transferee (default) or from-transferor.

cnam_lookup_enabledboolean nullable

Whether Caller ID Name (CNAM) lookup is enabled for the trunk. If enabled, all inbound calls to the SIP Trunk from the United States and Canada automatically perform a CNAM Lookup and display Caller ID data on your phone. See CNAM Lookups for more information.

auth_typestring nullable

The types of authentication mapped to the domain. Can be: IP_ACL and CREDENTIAL_LIST. If both are mapped, the values are returned in a comma delimited list. If empty, the domain will not receive any traffic.

symmetric_rtp_enabledboolean nullable

Whether Symmetric RTP is enabled for the trunk. When Symmetric RTP is disabled, Twilio will send RTP to the destination negotiated in the SDP. Disabling Symmetric RTP is considered to be more secure and therefore recommended. See Symmetric RTP for more information.

auth_type_setstring[] nullable

Reserved.

date_createdstring date-time nullable

The date and time in GMT when the resource was created specified in RFC 2822 format.

date_updatedstring date-time nullable

The date and time in GMT when the resource was last updated specified in RFC 2822 format.

sidstring nullable

The unique string that we created to identify the Trunk resource.

urlstring uri nullable

The absolute URL of the resource.

linksobject nullable

The URLs of related resources.

Changes

  • v1f944c667f44aRevision changes
    • breaking

      the response's property type changed from object to no type for status

    • info

      added the optional property to the response with the status

  • v1cec767a4c91cRevision changes
    • breaking

      the response's property type changed from no type to object for status