TwiML™ Voice: <Redirect>
The <Redirect> verb transfers control of a call to the TwiML at a different URL. All verbs after <Redirect> are unreachable and ignored.
Verb Attributes
The <Redirect> verb supports the following attributes that modify its behavior:
| Attribute Name | Allowed Values | Default Value |
|---|---|---|
| method | GET, POST | POST |
method
The 'method' attribute takes the value 'GET' or 'POST'. This tells Twilio
whether to request the <Redirect> URL via HTTP GET or POST. 'POST' is the default.
Use it in a <Redirect> verb like so:
Nouns
The "noun" of a TwiML verb is the stuff nested within the verb that's not a verb itself; it's the stuff the verb acts upon. These are the nouns for <Redirect>:
| Noun | TwiML Interpretation |
|---|---|
| plain text | An absolute or relative URL for a different TwiML document. |
Nesting Rules
No verbs can be nested within <Redirect> and <Redirect> can't be nested in any other verbs.
Examples
Example 1: Absolute URL Redirect
In this example, we have a <Redirect> verb after a <Dial>
verb with no URL. When the <Dial> verb finishes, the
<Redirect> executes. <Redirect> makes a request to http://www.foo.com/nextInstructions and
transfers the call flow to the TwiML received in response to that request.
Example 2: Relative URL Redirect
Redirects call flow control to the TwiML at a URL relative to the current URL.
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
