mindra

Quickstart

Run your first Mindra workflow in minutes

2 min read

Quickstart

Run your first Mindra workflow in just a few steps.

Prerequisites

Step 1: Run a Workflow

Send a POST request to trigger your workflow. Replace your-workflow-slug with the slug from your Mindra Console:

curl -X POST https://api.mindra.co/v1/workflows/your-workflow-slug/run \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Your task description here",
    "metadata": {}
  }'

Step 2: Get the Response

The API returns immediately with an execution ID and a stream URL:

{
  "execution_id": "exec_abc123",
  "status": "running",
  "workflow_slug": "your-workflow-slug",
  "workflow_name": "Your Workflow Name",
  "stream_url": "/api/v1/workflows/execute/exec_abc123/stream",
  "created_at": "2026-01-15T10:30:00Z",
  "conversation_id": null
}

Step 3: Stream Events

Connect to the stream_url to receive real-time execution events via SSE:

curl -N "https://api.mindra.co/api/v1/workflows/execute/exec_abc123/stream" \
  -H "x-api-key: YOUR_API_KEY"

You will receive events like chunk, tool_executing, tool_result, and done as the workflow executes.

Step 4: Handle the Result

When the workflow completes, you'll receive a done event with the final result. Your workflow is now running end-to-end!

Next Steps