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

Update application properties

Updates the properties of an existing application. Supply the fields you want to change, such as FriendlyName, VoiceUrl, or SmsUrl; URL fields must use URI format, and HTTP method fields accept GET or POST.

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

2 parameters · 16 body fields
AccountSidstringrequired
The SID of the account that created the application. Must be `AC` followed by 32 hexadecimal characters.
Sidstringrequired
The unique SID of the application to update. Must be `AP` followed by 32 hexadecimal characters.

Application properties to update. All fields are optional.

FriendlyNamestringoptional
A descriptive string that you create to describe the resource. It can be up to 64 characters long.
ApiVersionstringoptional
The API version to use to start a new TwiML session. Can be: `2010-04-01` or `2008-08-01`. The default value is your account's default API version.
VoiceUrlstringoptional
The URL we should call when the phone number assigned to this application receives a call.
VoiceMethodstringoptional
The HTTP method we should use to call `voice_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
VoiceFallbackUrlstringoptional
The URL that we should call when an error occurs retrieving or executing the TwiML requested by `url`.
VoiceFallbackMethodstringoptional
The HTTP method we should use to call `voice_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
StatusCallbackstringoptional
The URL we should call using the `status_callback_method` to send status information to your application.
StatusCallbackMethodstringoptional
The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST`.
Allowed:GETPOST
VoiceCallerIdLookupbooleanoptional
Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: `true` or `false`.
SmsUrlstringoptional
The URL we should call when the phone number receives an incoming SMS message.
SmsMethodstringoptional
The HTTP method we should use to call `sms_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
SmsFallbackUrlstringoptional
The URL that we should call when an error occurs while retrieving or executing the TwiML from `sms_url`.
SmsFallbackMethodstringoptional
The HTTP method we should use to call `sms_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
SmsStatusCallbackstringoptional
Same as message_status_callback: The URL we should call using a POST method to send status information about SMS messages sent by the application. Deprecated, included for backwards compatibility.
MessageStatusCallbackstringoptional
The URL we should call using a POST method to send message status information to your application.
PublicApplicationConnectEnabledbooleanoptional
Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or `false`.

1 status code
200Returns the updated application object, including its account SID, application SID, API version, timestamps, and configured URLs and callbacks.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Application resource.
api_versionstringoptional
The API version used to start a new TwiML session.
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.
friendly_namestringoptional
The string that you assigned to describe the resource.
message_status_callbackstringoptional
The URL we call using a POST method to send message status information to your application.
sidstringoptional
The unique string that that we created to identify the Application resource.
sms_fallback_methodstringoptional
The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_fallback_urlstringoptional
The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`.
sms_methodstringoptional
The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_status_callbackstringoptional
The URL we call using a POST method to send status information to your application about SMS messages that refer to the application.
sms_urlstringoptional
The URL we call when the phone number receives an incoming SMS message.
status_callbackstringoptional
The URL we call using the `status_callback_method` to send status information to your application.
status_callback_methodstringoptional
The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`.
Allowed:GETPOST
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.
voice_caller_id_lookupbooleanoptional
Whether we look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: `true` or `false`.
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 retrieving or executing the TwiML requested by `url`.
voice_methodstringoptional
The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_urlstringoptional
The URL we call when the phone number assigned to this application receives a call.
public_application_connect_enabledbooleanoptional
Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or `false`.

Error handling

The AccountSid path parameter must match the account SID format: AC followed by 32 hexadecimal characters. The Sid path parameter must match the application SID format: AP followed by 32 hexadecimal characters. URL fields must use URI format, and method fields such as VoiceMethod, SmsMethod, and StatusCallbackMethod must be GET or POST.