30 days free. No credit card. Full access from the moment you connect your site.

Start free trial

Empty Rank Math Redirection Trash

rank-math/delete-trashed-redirections permanently deletes every trashed redirection. It refuses without confirm: true.

The trash is where uncertainty goes, which is exactly why emptying it deserves a look first.

Before you run it

This removes every trashed rule at once, and the trash is where rules go when somebody was not sure. Trashed rules are inactive but restorable right up until this runs, and afterwards neither the rule nor its hit history exists. List them first with rank-math/list-redirections using status=trashed.

At a glance

Abilityrank-math/delete-trashed-redirections
ToolsetRank Math — toolset/rank-math
GroupRank Math › Redirections & 404s
RequiresRank Math SEO, active on the site
Capabilitymanage_options
SafetyDestructive — deletes stored values, and refuses to run without confirm: true
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Abilities Manager 0.0.34 and later

How it works

Trashing is the reversible move, and it accumulates. A site’s redirection trash is usually several rounds of “probably obsolete” decisions taken by different people at different times, and the only thing making them safe was that they were reversible.

Emptying removes that property from all of them simultaneously. It is one call that finalises every deferred decision at once.

Which is fine when the trash holds five rules from a cleanup last week and less fine when it holds sixty from a migration two years ago that somebody might still need.

So list them first. rank-math/list-redirections with status=trashed shows what is there, with hit counts.

Idempotent: emptying an empty trash is a no-op.

Input

NameTypeRequiredWhat it is
confirmbooleanYes — must be trueThe irreversibility gate. Without it the call is refused before anything is touched.

What comes back

NameTypeWhat it is
deletedintegerHow many rules were removed.
successbooleanWhether the call completed.
messagestringA one-line summary of what happened, suitable for showing a human.
error_codestringPresent only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation.

Example

Ask your assistant:

Empty the redirection trash.

It resolves to one call:

{
  "ability": "rank-math/delete-trashed-redirections",
  "parameters": {
    "confirm": true
  }
}

Worth knowing

  • Finalises every deferred decision in one call.
  • List the trash first — with hit counts.
  • Not recoverable.
  • Idempotent.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading