API Reference

Build on the
FlowMindLabs API

A REST API to programmatically create, run, and manage AI-powered workflows. Authenticate once, automate anything.

Authentication

All API requests require a Bearer token. Generate API keys from your workspace settings and rotate them anytime.

Webhooks

Receive real-time events when workflows start, complete, or fail. Signatures are HMAC-verified.

SDKs

Official SDKs for TypeScript and Python. Community SDKs for Go, Ruby, and Rust.

Rate Limits

Pro: 100 req/min. Enterprise: custom. All responses include rate limit headers.

Example request

curl -X POST https://api.flowmindlabs.ai/v1/workflows \
  -H "Authorization: Bearer $FLOWMINDLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily summary",
    "template_id": "tpl_weekly_status",
    "trigger": { "type": "cron", "cron": "0 9 * * 1-5" }
  }'

Endpoints

POST/v1/workflowsCreate a new workflow from a JSON definition or a template ID.

GET/v1/workflowsList all workflows in the authenticated workspace.

GET/v1/workflows/{id}Retrieve a single workflow by ID, including its current revision.

PATCH/v1/workflows/{id}Update a workflow definition. A new revision is created automatically.

DELETE/v1/workflows/{id}Archive a workflow. Archived workflows stop accepting new runs.

POST/v1/workflows/{id}/runsTrigger a new run of the workflow with the provided input payload.

GET/v1/workflows/{id}/runsList runs for a workflow, with filters for status, date, and trigger source.

GET/v1/runs/{id}Retrieve a single run, including node-level logs and outputs.

POST/v1/runs/{id}/cancelCancel a run that is currently in progress.

GET/v1/templatesList public templates available in the FlowMindLabs directory.

POST/v1/webhooksCreate a webhook trigger URL for a workflow. Returns a signed URL.