A redirect points at the wrong place, or you want to switch it off without deleting it.
redirects/update-redirect changes an existing redirect by id — its target, HTTP code, action, group, title or enabled state — touching only the fields you pass.
At a glance
| Ability | redirects/update-redirect |
| Toolset | Redirection — toolset/redirection |
| Group | Redirection |
| Requires | Redirection, active on the site |
| Capability | manage_options |
| Safety | Writes data — reversible |
| Repeatable | Idempotent — setting the same values again changes nothing |
| Ships in | AcrossAI Abilities Manager 0.0.43 and later |
How it works
Pass the redirect’s id and the fields to change. It reads the current redirect first and merges your changes onto it, so a partial call can never blank the fields it did not mention.
To enable or disable a redirect, pass enabled true or false. To move it, pass a new group_id. Retarget it with target, or change the action_code.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | integer | Yes | The redirect id to update. |
source | string | No | New source URL or path. |
target | string | No | New target URL. |
action_type | string | No | Change the action (url, error, pass, random, nothing). |
action_code | integer | No | Change the HTTP status code. |
group_id | integer | No | Move the redirect to another group. |
title | string | No | Change the human label. |
regex | boolean | No | Whether the source is a regular expression. |
enabled | boolean | No | Enable (true) or disable (false). |
What comes back
| Name | Type | What it is |
|---|---|---|
id | integer | The redirect’s id. |
redirect | object | The redirect after the change. |
success | boolean | Whether the call completed. |
message | string | A one-line summary suitable for showing a human. |
error_code | string | Present only on failure, such as no redirect with that id. |
Example
Ask your assistant:
Disable redirect 42.
It resolves to one call:
{
"ability": "redirects/update-redirect",
"parameters": {
"id": 42,
"enabled": false
}
}Worth knowing
- Only the fields you pass change; everything else is left exactly as it was.
- Reversible — disabling a redirect keeps it, so you can switch it back on. The destructive remove is a separate ability.
- Needs the Redirection plugin active; without it you get a clear “not active” message.
Related abilities
- List Redirects — find the id to update
- Create Redirect — make a new one
- Delete Redirects — remove one for good
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category