API Reference

Complete reference for the Mindra REST API.

Base URL

https://api.mindra.co

Authentication

All requests require an API key in the x-api-key header:

-H "x-api-key: YOUR_API_KEY"

Content Type

All request bodies should be JSON:

-H "Content-Type: application/json"

Endpoints

Method	Endpoint	Description
POST	/v1/workflows/{slug}/run	Run a workflow
GET	/api/v1/workflows/execute/{execution_id}/stream	Stream execution events
POST	/v1/workflows/execute/{execution_id}/approve/{approval_id}	Approve a tool execution
POST	/v1/workflows/execute/{execution_id}/reject/{approval_id}	Reject a tool execution

Response Format

All responses return JSON. Successful responses include the relevant data directly. Error responses follow this format:

{
  "error": "Error message",
  "code": "ERROR_CODE"
}