Create redirect
create_redirectCreate a URL redirect. Redirects have no draft: the rule applies on the live site without a publish, usually within minutes, and a source that matches a live page replaces that page for visitors. A source path can have only one active redirect (list_redirects shows the ones in use), and a redirect that leads back to its own source, directly or through other rules, is refused. A source of / (the home page) or a destination on another site needs confirm: true, sent only after the user agreed. If the answer was lost, check list_redirects for the source path before trying again.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | Source URL path (e.g. /old-page) | |
| confirm | No | Set true only after the user confirmed replacing the home page or sending visitors to another site | |
| permanent | No | Whether this is a permanent (301) or temporary (302) redirect | |
| projectId | Yes | The project ID | |
| description | No | Description of why this redirect exists | |
| destination | Yes | Destination URL path (e.g. /new-page) |