Workflows

Method	Path	Purpose
`POST`	`/api/v1/workflows/{workflow_id}/trigger`	Start a new run of a workflow definition
`GET`	`/api/v1/workflows/runs`	List runs (cursor-paginated)
`GET`	`/api/v1/workflows/runs/{run_id}`	Fetch one run’s full state, including step history
`POST`	`/api/v1/workflows/runs/{run_id}/pause`	Pause a running workflow
`POST`	`/api/v1/workflows/runs/{run_id}/resume`	Resume a paused run
`POST`	`/api/v1/workflows/runs/{run_id}/cancel`	Cancel a run — triggers compensation for completed side effects
`GET`	`/api/v1/workflows/approvals`	List pending approvals across runs
`POST`	`/api/v1/workflows/runs/{run_id}/approvals/{request_id}/respond`	Approve or reject a suspended approval step

Trigger a run

curl -X POST https://api.mael.in/api/v1/workflows/full-content-pipeline/trigger \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_id": "...",
    "inputs": { "target_keyword": "migraine treatment" }
  }'

Returns a run_id immediately — workflow execution is asynchronous. Stream live step events over the dashboard’s WebSocket, or poll GET /workflows/runs/{run_id}.

Respond to an approval

curl -X POST https://api.mael.in/api/v1/workflows/runs/$RUN_ID/approvals/$REQUEST_ID/respond \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"decision": "approved", "note": "Looks good"}'

A rejection feeds back into the run as a failure with the given reason — whether that triggers a revision loop or ends the run depends on the workflow definition.

API Reference

API Endpoints

Trigger a run

Respond to an approval

Workflow Engine architecture

​Trigger a run

​Respond to an approval

Workflow Engine architecture

Trigger a run

Respond to an approval