mailerpress-pro/delete-embed-key permanently deletes an embed API key. It requires confirm_id matching the ID.
Anything using it stops working at once.
Before you run it
Every embed form using this key stops working the moment it is deleted, and the failure appears on whatever site hosts the form rather than here. A signup form that silently stops submitting is the usual result, and the first sign is a list that stopped growing. Disabling the key with mailerpress-pro/update-embed-key has the same effect and is reversible.
At a glance
| Ability | mailerpress-pro/delete-embed-key |
| Toolset | MailerPress Pro — toolset/mailerpress-pro |
| Group | MailerPress Pro › Embed Keys |
| Requires | AcrossAI Pro, plus MailerPress with its Pro add-on active on the site |
| Capability | manage_options |
| Safety | Destructive — any embed using the key stops working immediately. Requires confirm_id. |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
The right use is revocation: a key that has leaked, or one belonging to a site that is no longer a partner. In both cases immediate and permanent is what you want.
The wrong use is tidying. A key with a name nobody recognises is still a key something may be using, and the listing does not report usage — so an unfamiliar name is not evidence that it is unused.
Disabling first is the way to find out. Set the status off, wait, and see whether anybody reports a broken form. If nothing breaks, deleting is safe; if something does, re-enabling is one call.
Deletion cannot be undone and the key cannot be recreated — a new key has a new value, which means updating the embed wherever it lives.
Idempotent.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | integer | Yes | The key to delete. |
confirm_id | integer | Yes | Must match id. |
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 |
|---|---|---|
id | integer | The key 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:
Revoke the leaked embed key.
It resolves to one call:
{
"ability": "mailerpress-pro/delete-embed-key",
"parameters": {
"id": 3,
"confirm_id": 3,
"confirm": true
}
}Worth knowing
- Embeds using it fail on the other site, silently from here.
- Disable first to find out whether anything uses it.
- A replacement key has a new value and needs deploying.
- Idempotent.
Related abilities
- MailerPress Pro Update Embed Key — disable it reversibly first
- MailerPress Pro Create Embed Key — issue a replacement
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category