- API & Docs
Realtime call modification allows you to interrupt an in-progress call and terminate it or have it begin processing TwiML from a new URL. This is useful for any application where you want to asynchronously change the behavior of a running call. For example: hold music, call queues, transferring calls, forcing hangup, etc.
To redirect or terminate a live call, you make an HTTP POST request to an in-progress Call instance resource URI:
The following parameters are available for you to POST when modifying a phone call:
|Url||A valid URL that returns TwiML. Twilio will immediately redirect the call to the new TwiML.|
|Method||The HTTP method Twilio should use when requesting the above URL. Defaults to
Note that any call which is currently ringing within a
<Dial> verb is in-progress from the point
of view of Twilio, and thus you must use 'Status=completed' to cancel it.
You may POST the following parameters:
|FallbackUrl||A URL that Twilio will request if an error occurs requesting or executing the TwiML at
|FallbackMethod||The HTTP method that Twilio should use to request the
|StatusCallback||A URL that Twilio will request when the call ends to notify your app.|
|StatusCallbackMethod||The HTTP method Twilio should use when requesting the above URL. Defaults to
Redirect a running call to a new URL
Terminate a running call