Reference
API endpoint reference
Every public endpoint, its auth method, and what it does. For request/response bodies and detailed guides, see the full documentation.
All public endpoints
Authenticate with Authorization: Bearer mhk_YOUR_TOKEN. Create tokens in the dashboard under Project Settings → API Tokens.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /v1/workflows | API Token | Trigger a workflow with input data. Returns a run_id for polling. |
| GET | /v1/workflows | API Token | List all workflows accessible with your token. |
| GET | /v1/workflows/{id} | API Token | Get workflow detail including trigger type, node graph, and settings. |
| GET | /v1/runs/{run_id} | API Token | Get run status with step-by-step outputs and timing. |
| GET | /v1/runs | API Token | List recent workflow runs, filterable by workflow_id or status. |
| POST | /v1/chat/completions | API Token | OpenAI-compatible chat completion. Supports streaming, multi-modal, and agentic RAG via x-agentic-rag header. |
| POST | /v1/webhooks/{project_id} | None (webhook secret) | Inbound webhook ingestion from external platforms. HMAC signature verification supported. |
| GET | /v1/pixel/{workflow_id}.gif | Query token | Email open tracking pixel. Returns 1×1 transparent GIF and fires email_opened trigger. |
| GET | /v1/usage | API Token | Get daily and monthly token usage, plus plan limits and suspension status. |
| GET | /v1/health | None | Health check — returns service status. |