API

Everything the interface can do, your systems can do too.

The Adanse API is workspace-scoped and governed by the same policies as the product. Approvals made through the API produce identical decision records and audit evidence.

Authentication

Workspace-scoped bearer tokens

curl https://api.adanse.example/v1/decisions?status=pending \
  -H "Authorization: Bearer $ADANSE_TOKEN" \
  -H "X-Adanse-Workspace: acme-ltd"

Tokens inherit the role of the identity that issued them. A member token can read; only a decider token can approve, reject or undo. Every call is attributed in the audit trail.

Endpoints

Core resources

GET/employees

List AI employees in the workspace with state, department and autonomy.

GET/employees/{slug}

One employee, including skills, capabilities and recent decisions.

GET/decisions?status=pending

List decision records, filterable by status, employee and risk.

GET/decisions/{reference}

One decision record with reasoning, inputs, policy and audit trail.

POST/decisions/{reference}/decide

Approve or reject a pending decision, with an optional note.

POST/decisions/{reference}/undo

Reverse a recent decision; the reversal is itself audited.

GET/memory

Query Business Memory by type, entity, source and freshness.

GET/graph

Fetch graph nodes and typed edges for the Intelligence Graph.

GET/audit

Append-only audit events, newest first, linked to their decision.

Errors

Predictable failure

401

No valid token, or the token's session has expired.

403

Authenticated, but the identity lacks authority for this action.

409

The decision has already been resolved by another approver.

422

Policy blocked the action; the response names the policy that applied.