Updates the application's properties

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

An Application instance resource represents an application that you have created with Twilio. An application inside of Twilio is just a set of URLs and other configuration data that tells Twilio how to behave when one of your Twilio numbers receives a call or SMS message.

Path parameters

AccountSid string Required

The SID of the Account that created the Application resources to update.

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
Sid string Required

The Twilio-provided string that uniquely identifies the Application resource to update.

Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AP[0-9a-fA-F]{32}$.

application/x-www-form-urlencoded

Body

FriendlyName string

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

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.
VoiceUrl string(uri)

The URL we should call when the phone number assigned to this application receives a call.
VoiceMethod string(http-method)

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

Values are GET or POST.
VoiceFallbackUrl string(uri)

The URL that we should call when an error occurs retrieving or executing the TwiML requested by url.
VoiceFallbackMethod string(http-method)

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

Values are GET or POST.
StatusCallback string(uri)

The URL we should call using the status_callback_method to send status information to your application.
StatusCallbackMethod string(http-method)

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

Values are GET or POST.
VoiceCallerIdLookup boolean

Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: true or false.
SmsUrl string(uri)

The URL we should call when the phone number receives an incoming SMS message.
SmsMethod string(http-method)

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

Values are GET or POST.
SmsFallbackUrl string(uri)

The URL that we should call when an error occurs while retrieving or executing the TwiML from sms_url.
SmsFallbackMethod string(http-method)

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

Values are GET or POST.
SmsStatusCallback string(uri)

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.
MessageStatusCallback string(uri)

The URL we should call using a POST method to send message status information to your application.
PublicApplicationConnectEnabled boolean

Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: true or false.

Responses

200 application/json

OK
Hide headers attributes Show headers attributes
- Access-Control-Allow-Origin string
  
  Specify the origin(s) allowed to access the resource
- Access-Control-Allow-Methods string
  
  Specify the HTTP methods allowed when accessing the resource
- Access-Control-Allow-Headers string
  
  Specify the headers allowed when accessing the resource
- Access-Control-Allow-Credentials boolean
  
  Indicates whether the browser should include credentials
- Access-Control-Expose-Headers string
  
  Headers exposed to the client
Hide response attributes Show response attributes object
- account_sid string | null
  
  The SID of the Account that created the Application resource.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- api_version string | null
  
  The API version used to start a new TwiML session.
- date_created string(date-time-rfc-2822) | null
  
  The date and time in GMT that the resource was created specified in RFC 2822 format.
- date_updated string(date-time-rfc-2822) | null
  
  The date and time in GMT that the resource was last updated specified in RFC 2822 format.
- friendly_name string | null
  
  The string that you assigned to describe the resource.
- message_status_callback string(uri) | null
  
  The URL we call using a POST method to send message status information to your application.
- sid string | null
  
  The unique string that that we created to identify the Application resource.
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AP[0-9a-fA-F]{32}$.
- sms_fallback_method string(http-method) | null
  
  The HTTP method we use to call sms_fallback_url. Can be: GET or POST.
  
  Values are GET or POST.
- sms_fallback_url string(uri) | null
  
  The URL that we call when an error occurs while retrieving or executing the TwiML from sms_url.
- sms_method string(http-method) | null
  
  The HTTP method we use to call sms_url. Can be: GET or POST.
  
  Values are GET or POST.
- sms_status_callback string(uri) | null
  
  The URL we call using a POST method to send status information to your application about SMS messages that refer to the application.
- sms_url string(uri) | null
  
  The URL we call when the phone number receives an incoming SMS message.
- status_callback string(uri) | null
  
  The URL we call using the status_callback_method to send status information to your application.
- status_callback_method string(http-method) | null
  
  The HTTP method we use to call status_callback. Can be: GET or POST.
  
  Values are GET or POST.
- uri string | null
  
  The URI of the resource, relative to https://api.twilio.com.
- voice_caller_id_lookup boolean | null
  
  Whether we look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: true or false.
- voice_fallback_method string(http-method) | null
  
  The HTTP method we use to call voice_fallback_url. Can be: GET or POST.
  
  Values are GET or POST.
- voice_fallback_url string(uri) | null
  
  The URL that we call when an error occurs retrieving or executing the TwiML requested by url.
- voice_method string(http-method) | null
  
  The HTTP method we use to call voice_url. Can be: GET or POST.
  
  Values are GET or POST.
- voice_url string(uri) | null
  
  The URL we call when the phone number assigned to this application receives a call.
- public_application_connect_enabled boolean | null
  
  Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: true or false.

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

curl \
 --request POST 'https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Applications/{Sid}.json' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --data 'SmsUrl=https%3A%2F%2Fexample.com&VoiceUrl=https%3A%2F%2Fexample.com&SmsMethod=GET&VoiceMethod=GET&FriendlyName=friendly_name&SmsFallbackUrl=https%3A%2F%2Fexample.com&StatusCallback=https%3A%2F%2Fexample.com&VoiceFallbackUrl=https%3A%2F%2Fexample.com&SmsFallbackMethod=GET&SmsStatusCallback=https%3A%2F%2Fexample.com&VoiceCallerIdLookup=true&VoiceFallbackMethod=GET&StatusCallbackMethod=GET&MessageStatusCallback=https%3A%2F%2Fexample.com&PublicApplicationConnectEnabled=true'

Request example

{"SmsUrl"=>"https://example.com", "VoiceUrl"=>"https://example.com", "SmsMethod"=>"GET", "VoiceMethod"=>"GET", "FriendlyName"=>"friendly_name", "SmsFallbackUrl"=>"https://example.com", "StatusCallback"=>"https://example.com", "VoiceFallbackUrl"=>"https://example.com", "SmsFallbackMethod"=>"GET", "SmsStatusCallback"=>"https://example.com", "VoiceCallerIdLookup"=>true, "VoiceFallbackMethod"=>"GET", "StatusCallbackMethod"=>"GET", "MessageStatusCallback"=>"https://example.com", "PublicApplicationConnectEnabled"=>true}

Response examples (200)

{
  "sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Applications/APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.json",
  "sms_url": "http://example.com",
  "voice_url": "http://example.com",
  "sms_method": "GET",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "api_version": "2010-04-01",
  "date_created": "Mon, 22 Aug 2011 20:59:45 +0000",
  "date_updated": "Tue, 18 Aug 2015 16:48:57 +0000",
  "voice_method": "GET",
  "friendly_name": "Application Friendly Name",
  "status_callback": "http://example.com",
  "sms_fallback_url": "http://www.example.com/sms-fallback",
  "voice_fallback_url": "http://www.example.com/voice-callback",
  "sms_fallback_method": "GET",
  "sms_status_callback": "http://www.example.com/sms-status-callback",
  "voice_fallback_method": "GET",
  "status_callback_method": "GET",
  "voice_caller_id_lookup": false,
  "message_status_callback": "http://www.example.com/sms-status-callback",
  "public_application_connect_enabled": true
}