mailerpress/delete-template permanently deletes a template. It requires confirm_name matching the template’s current title.
Campaigns built from it are unaffected.
Before you run it
The template and its content go permanently. Campaigns that were based on it are not affected — they carry their own snapshot — so nothing sending breaks. What is lost is the reusable design, and nothing keeps a copy. mailerpress/get-template first if there is any chance it will be wanted again.
At a glance
| Ability | mailerpress/delete-template |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Templates |
| Requires | AcrossAI Pro, plus MailerPress active on the site |
| Capability | manage_options |
| Safety | Destructive — deletes the template permanently. Requires confirm_name. Campaigns built from it are unaffected. |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
That independence is the useful property. A campaign takes a snapshot of the template at creation and holds its own artifacts afterwards, so deleting the template cannot break anything that has already been built or sent.
It is also why a template deletion is the mildest destructive operation in the MailerPress suite: nothing that sends depends on it.
What is lost is the design work. A template somebody built carefully is not recoverable, and there is no trash.
On a site with many near-duplicate templates, deleting the unused ones is real tidying — and telling the unused from the merely unmentioned means checking which campaigns were built from what, which nothing reports directly.
The name guard is checked against the current title.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | integer | Yes | The template. |
confirm_name | string | Yes | Must match the template’s current title. |
confirm | boolean | Yes — must be true | The irreversibility gate. Without it the call is refused before anything is touched. |
What comes back
| Name | Type | What it is |
|---|---|---|
deleted | boolean | Whether the template was removed. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present 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:
Delete that unused template.
It resolves to one call:
{
"ability": "mailerpress/delete-template",
"parameters": {
"id": 5,
"confirm_name": "Monthly newsletter",
"confirm": true
}
}Worth knowing
- Campaigns built from it carry their own snapshot and are unaffected.
- The design work is lost and there is no trash.
- Nothing reports which campaigns came from which template.
- Idempotent.
Related abilities
- MailerPress Get Template — take a copy of the body first
- MailerPress List Templates — find the near-duplicates
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category