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

Start free trial

MailerPress List Failed Workflow Jobs

mailerpress/list-failed-workflow-jobs returns a global list of failed workflow jobs across every workflow.

It is capped at five hundred rows by MailerPress, with no pagination.

At a glance

Abilitymailerpress/list-failed-workflow-jobs
ToolsetMailerPress — toolset/mailerpress
GroupMailerPress › Workflows
RequiresAcrossAI Pro, plus MailerPress active on the site
Capabilitymanage_options
SafetyRead-only — changes nothing
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Pro 0.9.16 and later

How it works

The cap is a hard one. A site with more than five hundred failures gets the first five hundred and no indication that more exist, so interval — the window in days — is the only way to see a complete picture on a busy site.

The endpoint accepts no per-workflow filter. Callers that need one must post-filter the returned array on automation_id themselves, which this page states rather than pretending the capability exists.

For one workflow specifically, mailerpress/get-workflow-logs is the paginated per-workflow read and is the better call.

The value of the global view is pattern-spotting: failures concentrated in one workflow point at that workflow, and failures spread across all of them at the same time point at something shared — a mail provider outage, a scheduler problem.

Remember that exits are normalised to failures in MailerPress’s own display, though this endpoint reports genuinely failed jobs.

Input

NameTypeRequiredWhat it is
intervalintegerNoWindow in days. The only way to narrow the result.

What comes back

NameTypeWhat it is
failed_jobsarrayFailed jobs across every workflow, capped at 500.
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:

Are any automations failing?

It resolves to one call:

{
  "ability": "mailerpress/list-failed-workflow-jobs",
  "parameters": {
    "interval": 7
  }
}

Worth knowing

  • Hard cap of 500 with no indication that more exist.
  • No per-workflow filter — post-filter on automation_id yourself.
  • The per-workflow log is the better call for one workflow.
  • Failures spread across everything point at something shared.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading