mailerpress/list-workflows returns a paginated list of MailerPress workflows, filterable by status and trigger type. Each row includes stats and A/B test information.
The status values worth filtering on are DRAFT, ENABLED and DISABLED.
At a glance
| Ability | mailerpress/list-workflows |
| Toolset | MailerPress — toolset/mailerpress |
| Group | MailerPress › Workflows |
| Requires | AcrossAI Pro, plus MailerPress active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
Status is unvalidated server-side, which means a typo in the filter returns nothing rather than erroring — and nothing reads as “no workflows in that state”.
So sticking to the three known values matters more than it usually would.
ENABLED is the one that means anything is happening. A disabled workflow keeps its configuration and its history and does not run; a draft has never run.
The per-row stats make this a health check as well as an inventory. A workflow enabled months ago with zero runs has a trigger that never fires, which is a configuration problem wearing the appearance of a quiet audience.
The parameter name MailerPress uses here is perPages, which is translated from the ordinary per_page at the boundary.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
status | string | No | DRAFT, ENABLED or DISABLED. |
trigger_type | string | No | Restrict to one trigger type. |
per_page | integer | No | Rows per page. |
What comes back
| Name | Type | What it is |
|---|---|---|
workflows | array | Each workflow with its status, stats and A/B test info. |
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:
What automations are running?
It resolves to one call:
{
"ability": "mailerpress/list-workflows",
"parameters": {
"status": "ENABLED"
}
}Worth knowing
- Status is unvalidated — a typo returns nothing and reads as an empty result.
- Enabled with zero runs means a trigger that never fires.
- Disabled keeps configuration and history; draft has never run.
- Read-only.
Related abilities
- MailerPress Get Workflow — one workflow with its node tree
- MailerPress Get Workflow Stats — why it is not running
- MailerPress Update Workflow Status — enable or disable
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category