API Reference

Returns platform health. Use as a liveness check before integration tests.

# Response 200
{ "status": "ok" }

List process definitions for your tenant.

Create a process definition. Versioned on write — each write creates a new version effective from the write timestamp.

{
  "name":        "Invoice Reconciliation",
  "description": "Nightly agent reconciliation with CFO sign-off gate",
  "tasks": [
    {
      "taskId":   "recon-agent",
      "execType": "AGENT",
      "label":    "Agent reconciliation"
    },
    {
      "taskId":        "cfo-signoff",
      "execType":      "HUMAN",
      "label":         "CFO sign-off",
      "deadlineSeconds": 86400
    }
  ],
  "flows": [
    {
      "from":      "recon-agent",
      "to":        "cfo-signoff",
      "condition": "detail.status == FAILED"
    }
  ]
}

Run history for a process, newest first.

Current derived health (Red / Yellow / Green) and per-task state for the most recent run.

{
  "processId": "proc-001",
  "runId":     "MEC-20260916T044343Z",
  "health":   "GREEN",
  "tasks": [
    { "taskId": "recon-agent", "status": "SUCCESS" },
    { "taskId": "cfo-signoff",  "status": "PENDING" }
  ]
}

Policies currently attached to a process, current version only.

List all policy types available to your tenant.

Create a policy. Effective-dated on write. Changing a policy does not require a deployment.

{
  "processId":  "proc-001",
  "taskId":     "cfo-signoff",
  "policyType": "escalate",
  "config": {
    "escalateTo": "coo@yourco.com",
    "channel":    "email",
    "afterSeconds": 3600
  }
}

Read a specific policy version.

List pending approvals addressed to the authenticated caller. Returns approvals where the caller is the named assignee.

Read a specific approval with full context: what the agent or system proposed, downstream consequence, policy version in force, and current decision chain.

{
  "approvalId":   "apr-20260916-04721",
  "runId":        "MEC-20260916T044343Z",
  "taskId":       "cfo-signoff",
  "assignee":     "cfo@yourco.com",
  "status":       "PENDING",
  "deadline":     "2026-09-17T04:43:43Z",
  "context": {
    "agentOutput": "Variance of $4,210 on invoice #48291",
    "confidence":  0.91,
    "consequence": "Approval posts the reconciled entry"
  },
  "policyVersion": "INVOICE_AUTO v3",
  "chain": []
}

Settle as approved. Run resumes and the next task dispatches. Decision is recorded with actor, timestamp, and policy version in force.

# Body optional
{ "note": "Reviewed source rows — variance within tolerance" }

Settle as rejected. Run does not continue past the rejected task. Decision and reason are recorded.

{ "reason": "Source invoice does not match. Routing to investigation." }

Pass authority to a named delegate. Hop is recorded in the decision chain. Approval is repointed to the delegate.

{
  "delegateTo": "controller@yourco.com",
  "note":       "Delegating — out of office until Monday"
}

Write an approval history record. Append-only. Requires audit:write scope.

Read the complete decision chain for a run — every decision, every hop, every actor, every timestamp.

{
  "runId": "MEC-20260916T044343Z",
  "chain": [
    {
      "actor":    "cfo@yourco.com",
      "kind":     "Person",
      "action":   "APPROVED",
      "at":       "2026-09-16T06:14:22Z",
      "policy":   "INVOICE_AUTO v3",
      "note":     "Variance within tolerance"
    }
  ]
}

Given identifiers you already hold, returns display name, identity kind and delivery address for each.

# Request
{ "identifiers": ["cfo@yourco.com", "svc-account-001"] }

# Response
{
  "resolved": [
    {
      "identifier": "cfo@yourco.com",
      "kind":       "Person",
      "displayName":"Sarah Chen",
      "email":      "cfo@yourco.com"
    },
    {
      "identifier": "svc-account-001",
      "kind":       "Service",
      "displayName":"Reconciliation service"
    }
  ]
}