Before you create a redirect, you want to see what is already there — and which ones are actually being hit.
redirects/list-redirects returns a filterable, paginated list of the site’s redirects, with their source and target, HTTP code, group, hit count and whether they are enabled.
At a glance
| Ability | redirects/list-redirects |
| Toolset | Redirection — toolset/redirection |
| Group | Redirection |
| Requires | Redirection, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.43 and later |
How it works
Filter by enabled state, by group, or by a substring of the source or target, and page through the results. Order by last access, hit count or position.
Each row carries the source, the target, the HTTP code, the match and action type, the group, the hit count and last-access, and whether it is enabled — everything you need before creating or changing one.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
status | string | No | all, enabled or disabled. Default all. |
group_id | integer | No | Only redirects in this group. |
source | string | No | Match a substring of the source URL. |
target | string | No | Match a substring of the target URL. |
per_page | integer | No | Page size, 5–200 (default 25). |
page | integer | No | 1-based page number. |
orderby | string | No | source, last_count (hits), last_access or position. |
direction | string | No | asc or desc (default desc). |
What comes back
| Name | Type | What it is |
|---|---|---|
redirects | array | The matching redirects with their source, target, code, group, hits and enabled state. |
count | integer | How many were returned on this page. |
total | integer | How many match in total. |
page | integer | The page returned. |
success | boolean | Whether the call completed. |
Example
Ask your assistant:
Show me the 20 most-hit redirects.
It resolves to one call:
{
"ability": "redirects/list-redirects",
"parameters": {
"orderby": "last_count",
"direction": "desc",
"per_page": 20
}
}Worth knowing
- Read-only — it reads the redirect table and writes nothing.
- Check here before creating a redirect so you do not duplicate one.
- Needs the Redirection plugin active; without it you get a clear “not active” message.
Related abilities
- Create Redirect — make a new one
- Update Redirect — change or disable one
- Delete Redirects — remove them
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category