API reference.

Authentication

All requests authenticate with a bearer token tied to a workspace.

curl https://api.entilla.com/v1/ask \
  -H "Authorization: Bearer $ENTILLA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Why did Acme churn?","cite":true}'

POST /v1/ask

Ask a question against the graph. Returns text with citations and a trace ID.

{
  "query": "string",
  "scope": { "accounts": ["Acme"] },
  "cite": true,
  "model": "entilla-pro"
}

POST /v1/workflows/:id/run

Run a deployed workflow with structured inputs.

{
  "input": { "account": "Acme" },
  "env": "production",
  "idempotencyKey": "renewal-2025-04-acme"
}

Errors

{
  "error": {
    "code": "rate_limited",
    "message": "Too many concurrent runs",
    "retryAfterMs": 1200
  }
}