automations

Run Manual Trigger

Run a manual automation trigger.

Only triggers whose event is manual can be run through the API. The trigger's actions run under the same cooldown/burst/monthly-budget limits as message/timer/schedule triggers, with the bot as the action author. There is no member or channel context, so per-member work must go through a for_each_member action inside the trigger.

Pass an optional context map to supply extra template variables to the run, a flat map of scalars, readable in the trigger's actions as {{ key }}. Unknown variables render as empty, so a trigger that references a variable you didn't send still runs.

skipped is true when the trigger was found and allowed to run but Monni chose not to execute its actions, either because its top-level conditions evaluated false or because an abuse-prevention gate (per-trigger cooldown, guild burst cap, monthly execution budget) rejected the run. Nothing ran, and errors is empty. A skipped run still counts against your rate limits.

Runs are counted against the automation-runs limit on top of the limits every endpoint shares.

Requires an API key with the automations.run permission.

post/v1/automations/{trigger_id}/run

Path parameters

trigger_idstring required

Request body

contextobject

Flat map of extra template variables, addressable in the trigger's actions as {{ key }}. Values must be scalars, so no nested objects or arrays. Keys must be valid identifiers and cannot be one of: channel, guild, member, message, vars

Example request

{
  "context": {
    "priority": 3,
    "ticket_id": "T-4021",
    "urgent": true
  }
}

Response

Successful Response

errorsstring[]

skippedboolean

Changes

No recorded changes to this endpoint across all 2 revisions of this API.