Twilio API (unofficial showcase)
POST/2010-04-01/Accounts/{AccountSid}/SIP/Domains/{Sid}.json

Update a SIP domain

Updates the configuration of a SIP domain. Supply only the attributes you want to change; method fields accept GET or POST, and URL fields must be valid URIs.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 13 body fields
AccountSidstringrequired
The account identifier, in the format `AC` followed by 32 hexadecimal characters.
Sidstringrequired
The SIP domain identifier, in the format `SD` followed by 32 hexadecimal characters.

Optional SIP domain attributes to update; provide only the fields you want to change.

FriendlyNamestringoptional
A descriptive string that you created to describe the resource. It can be up to 64 characters long.
VoiceFallbackMethodstringoptional
The HTTP method we should use to call `voice_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
VoiceFallbackUrlstringoptional
The URL that we should call when an error occurs while retrieving or executing the TwiML requested by `voice_url`.
VoiceMethodstringoptional
The HTTP method we should use to call `voice_url`
Allowed:GETPOST
VoiceStatusCallbackMethodstringoptional
The HTTP method we should use to call `voice_status_callback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
VoiceStatusCallbackUrlstringoptional
The URL that we should call to pass status parameters (such as call ended) to your application.
VoiceUrlstringoptional
The URL we should call when the domain receives a call.
SipRegistrationbooleanoptional
Whether to allow SIP Endpoints to register with the domain to receive calls. Can be `true` or `false`. `true` allows SIP Endpoints to register with the domain to receive calls, `false` does not.
DomainNamestringoptional
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 `sip.twilio.com`.
EmergencyCallingEnabledbooleanoptional
Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.
Securebooleanoptional
Whether secure SIP is enabled for the domain. If enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls to this sip domain.
ByocTrunkSidstringoptional
The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.
EmergencyCallerSidstringoptional
Whether an emergency caller sid is configured for the domain. If present, this phone number will be used as the callback for the emergency call.

1 status code
200Returns the updated SIP domain, including its account and domain identifiers, configuration, and resource URI.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the SipDomain resource.
api_versionstringoptional
The API version used to process the call.
auth_typestringoptional
The types of authentication you have mapped to your domain. Can be: `IP_ACL` and `CREDENTIAL_LIST`. If you have both defined for your domain, both will be returned in a comma delimited string. If `auth_type` is not defined, the domain will not be able to receive any traffic.
date_createdstringoptional
The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
domain_namestringoptional
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 `sip.twilio.com`.
friendly_namestringoptional
The string that you assigned to describe the resource.
sidstringoptional
The unique string that that we created to identify the SipDomain resource.
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.
voice_fallback_methodstringoptional
The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_fallback_urlstringoptional
The URL that we call when an error occurs while retrieving or executing the TwiML requested from `voice_url`.
voice_methodstringoptional
The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_status_callback_methodstringoptional
The HTTP method we use to call `voice_status_callback_url`. Either `GET` or `POST`.
Allowed:GETPOST
voice_status_callback_urlstringoptional
The URL that we call to pass status parameters (such as call ended) to your application.
voice_urlstringoptional
The URL we call using the `voice_method` when the domain receives a call.
subresource_urisobjectoptional
A list of mapping resources associated with the SIP Domain resource identified by their relative URIs.
sip_registrationbooleanoptional
Whether to allow SIP Endpoints to register with the domain to receive calls.
emergency_calling_enabledbooleanoptional
Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.
securebooleanoptional
Whether secure SIP is enabled for the domain. If enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls to this sip domain.
byoc_trunk_sidstringoptional
The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.
emergency_caller_sidstringoptional
Whether an emergency caller sid is configured for the domain. If present, this phone number will be used as the callback for the emergency call.

Error handling

VoiceFallbackMethod, VoiceMethod, and VoiceStatusCallbackMethod must be GET or POST; DomainName must end with sip.twilio.com. The AccountSid path parameter must match the AC prefix followed by 32 hexadecimal characters, and the Sid path parameter must match the SD prefix followed by 32 hexadecimal characters.