{"__v":3,"_id":"544f87becf9f860800801487","category":{"__v":21,"_id":"543bf3e22a30961a00b66eb3","pages":["5489d5e61ea5330b007b5a51","5489e243d8dec60b00034297","5489e318aefb240b00d197ef","56cdf622e538330b0021ab5a"],"project":"542dbe0ecb19820800c1f4d7","version":"542ecc0a6b0eb6080066ca77","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-13T15:46:42.097Z","from_sync":false,"order":1,"slug":"inboundxml","title":"InboundXML"},"is_link":false,"parentDoc":null,"project":"542dbe0ecb19820800c1f4d7","user":"544a586d27b7fc140078db12","version":{"__v":29,"_id":"542ecc0a6b0eb6080066ca77","forked_from":"542dbe0fcb19820800c1f4da","project":"542dbe0ecb19820800c1f4d7","createdAt":"2014-10-03T16:17:14.165Z","releaseDate":"2014-10-03T16:17:14.165Z","categories":["542ecc0a6b0eb6080066ca78","542ef44f6b0eb6080066cb24","543bf3e22a30961a00b66eb3","5446952b82bd7e08002768a0","544821ae8d7af31a00dd41ce","544a7885f1aefa08006efc69","544c758e11845f0e001ed8de","544e5565b80812080035be55","544e558dbd51b9080037f8ca","5450b045a66f020800dba73d","5450eb6aa66f020800dba945","5450f39ea66f020800dba989","5450f877a66f020800dba9cf","54510356a66f020800dbaa17","5451274514af501a00b50c99","54513345a66f020800dbab24","54513cc014af501a00b50d24","54515eec14af501a00b50db9","54519b1d14af501a00b50ea9","54519b2aa66f020800dbacb4","54524f9704160008005b1d27","54538d2308d1800800473d95","54538d420c09721000a06a03","54538e5608d1800800473d9a","5453ea9547c30114004fb375","5453eb12b077c31c00067bcb","5453eb27b077c31c00067bcd","5453ed5db077c31c00067bde","548075cbe291c51a00e7e096"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-28T12:10:38.138Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":false,"results":{"codes":[]},"settings":"","try":true,"auth":"never","params":[],"url":""},"isReference":false,"order":14,"body":"The `<Redirect>` element directs the call to another InboundXML document. The URL of the InboundXML document is nested within the `<Redirect>` element, and the method attribute sets if the request will be a GET or POST. In addition to the default voice request parameters, the parameter UrlBase will also be forwarded when the redirect request is made. UrlBase points to the base InboundXML document where the `<Redirect>` occurred.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"method\",\n    \"0-1\": \"Method used to request the InboundXML document the call is being redirected to. Default Value: POST. Allowed Value: POST or GET.\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Nesting\",\n  \"body\": \"In addition to the default `<Response>` element, the `<Redirect>` element cannot be nested within any other elements. The `<Redirect>` element cannot nest any other elements within itself. It must only nest the URL that the call should be redirected to.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Examples\"\n}\n[/block]\nThe InboundXML below will say “You will now be redirected.” and then redirect the call to the given URL. The second `<Say>` will never execute.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<Response>\\n  <Say>You will now be redirected.</Say>\\n    <Redirect method=\\\"POST\\\">http://example.com/rest.xml</Redirect>\\n  <Say>You will never hear this.</Say>\\n</Response>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"redirect","type":"basic","title":"<Redirect>"}
The `<Redirect>` element directs the call to another InboundXML document. The URL of the InboundXML document is nested within the `<Redirect>` element, and the method attribute sets if the request will be a GET or POST. In addition to the default voice request parameters, the parameter UrlBase will also be forwarded when the redirect request is made. UrlBase points to the base InboundXML document where the `<Redirect>` occurred. [block:parameters] { "data": { "h-0": "Attribute", "h-1": "Description", "0-0": "method", "0-1": "Method used to request the InboundXML document the call is being redirected to. Default Value: POST. Allowed Value: POST or GET." }, "cols": 2, "rows": 1 } [/block] [block:callout] { "type": "info", "title": "Nesting", "body": "In addition to the default `<Response>` element, the `<Redirect>` element cannot be nested within any other elements. The `<Redirect>` element cannot nest any other elements within itself. It must only nest the URL that the call should be redirected to." } [/block] [block:api-header] { "type": "basic", "title": "Examples" } [/block] The InboundXML below will say “You will now be redirected.” and then redirect the call to the given URL. The second `<Say>` will never execute. [block:code] { "codes": [ { "code": "<Response>\n <Say>You will now be redirected.</Say>\n <Redirect method=\"POST\">http://example.com/rest.xml</Redirect>\n <Say>You will never hear this.</Say>\n</Response>", "language": "xml" } ] } [/block]