MechaMental
Concepts

Actions

Scheduled and triggered endpoint invocations for automated workflows.

Actions let you invoke endpoints on a schedule or trigger. Instead of waiting for external HTTP requests, actions proactively run your pipelines at defined intervals, at a specific time, or on demand.

Action Types

TypeDescription
cronRuns on a recurring schedule defined by a cron expression
one_timeRuns once at a specific date and time
manualRuns only when explicitly triggered by a user or API call

Configuration

Each action is configured with:

FieldDescription
EndpointWhich endpoint to invoke when the action fires
PayloadThe JSON request body to send to the endpoint
ScheduleWhen to run — a cron expression (for cron type), a specific datetime (for one_time), or on-demand (for manual)
Enabled/DisabledToggle to pause an action without deleting it

Cron Expressions

Cron actions use standard five-field cron expressions:

*/15 * * * *    Every 15 minutes
0 9 * * 1-5     Weekdays at 9:00 AM
0 0 * * *       Daily at midnight
0 */6 * * *     Every 6 hours
0 0 1 * *       First day of every month

The schedule field accepts any valid cron expression. The UI shows a human-readable description of the schedule alongside the raw expression.

Enabling and Disabling

Every action has an enabled/disabled toggle. Disabling an action pauses its schedule without deleting the configuration. This is useful for temporarily stopping a recurring job during maintenance or debugging.

Execution History

Every action execution is logged with:

  • Status — whether the execution succeeded or failed
  • Start time — when the execution began
  • Duration — how long the execution took
  • Output — the response from the endpoint

You can review past executions to monitor reliability and troubleshoot failures. Failed executions include error details to help diagnose issues.

Use Cases

Common use cases for actions include: daily report generation, periodic data sync, scheduled model evaluation, automated content updates, batch processing, and recurring health checks.

On this page