Sample - Twilio API
POST/2010-04-01/Accounts/{AccountSid}/Applications/{Sid}.json

Update an application

Updates the configuration of an existing application within an account. Supply only the application properties you want to change, including callback URLs, callback methods, API version, or FriendlyName.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters · 16 body fields
AccountSidstringrequired
The 34-character SID of the account containing the application. Must match the `AC` account SID format.
Sidstringrequired
The 34-character SID that uniquely identifies the application to update. Must match the `AP` application SID format.

Application properties to update, including voice, SMS, callback, API version, and naming settings.

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, callback configuration, timestamps, and resource URI.
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

AccountSid must be a 34-character SID matching the AC account pattern, and Sid must be a 34-character SID matching the AP application pattern. URL fields must use valid URIs, HTTP method fields must be GET or POST, and ApiVersion must be 2010-04-01 or 2008-08-01 when provided.