Getting started

• Authentication: API key in Authorization: Bearer <key>
• Base URL: https://managai.io
• Rate limits: 60 req/min default, higher on paid tiers.

Ingest API (POST /api/ingest)

Send events from your agents to Managai.

{
  "status": "running|idle|error|warning|paused",
  "health": 0-100,
  "tasks": 12,
  "errors": 0,
  "cost": 0.42,
  "message": "optional event text"
}

// JavaScript
await fetch("https://managai.io/api/ingest", {
  method: "POST",
  headers: { Authorization: "Bearer ack_...", "Content-Type": "application/json" },
  body: JSON.stringify({ status: "running", health: 98, tasks: 1, errors: 0, cost: 0.01 })
});

# Python
import requests
requests.post("https://managai.io/api/ingest",
  headers={"Authorization":"Bearer ack_..."},
  json={"status":"running","health":98,"tasks":1,"errors":0,"cost":0.01})

curl -X POST https://managai.io/api/ingest \
  -H "Authorization: Bearer ack_..." \
  -H "Content-Type: application/json" \
  -d '{"status":"running","health":98,"tasks":1,"errors":0,"cost":0.01}'

Agent runs API

Trigger agent runs programmatically via POST /api/agents/run.

For workflows, use POST /api/workflows/run (authenticated) or webhook trigger URLs for workflow automation.

Events and webhooks

Receive workflow events via webhook triggers: POST /api/webhooks/<token>.

{
  "event": "workflow.step.completed",
  "workflow_id": "uuid",
  "workflow_run_id": "uuid",
  "step_order": 1,
  "payload": { "input": "...", "output": "..." }
}

Verification: sign outbound webhook payloads with HMAC (coming soon).

SDKs

Official SDKs coming soon.