Skip to content
← Back to home

§ DOCUMENTATION

Documentation.

Everything you need to integrate, configure, and operate Execlave.

§ Copy prompt · paste into your AI coding assistant
Integrate Execlave into my project. Install @execlave/sdk (npm) or execlave-sdk (pip). Initialize with:  const exe = new Execlave({ apiKey: process.env.EXECLAVE_API_KEY, baseUrl: 'https://api.execlave.com' }); Register my agent:  await exe.registerAgent({ agentId: 'my-agent', name: 'My Agent', type: 'chatbot', platform: 'custom' }); Wrap LLM calls:  const trace = exe.startTrace({ agentId: 'my-agent' });  trace.setInput(userMessage);  const response = await llm.call(userMessage);  trace.setOutput(response).setModel('gpt-4').finish(); Add shutdown handler:  process.on('SIGTERM', () => exe.shutdown()); See full guide: /docs/getting-started
§ 01

Getting Started

§ 02

Policies & Governance

§ 03

Runtime Governance & Identity

Approval Workflows 2.0

New

Human-in-the-loop approvals with computed risk scores, tier routing, SLA escalation, and a continuous authorization-certificate verification loop.

Agent Identity

New

Issue short-lived RS256 exe_agt_ credentials and verify them offline against a public JWKS endpoint — verifiable identity for machine-to-machine and agent-to-agent calls.

Policy-as-Code

New

Author policies as JSON/YAML bundles, validate with execlave policies lint, reconcile with sync, and audit every change through tamper-evident version history.

Runtime Guardrails

New

Per-agent tool-invocation allow/deny policy, tool-output PII/injection scanning, and agent-to-agent credential authorization.

Agent Passport

New

Delegation chain-of-custody, capability inheritance, revocation cascade, declared-vs-observed shadow-tool diff, and a non-human-identity inventory.

Red-Team Gate

New

Run an adversarial probe suite with execlave test; gate promotion to the autonomous tier on a minimum resilience score (0.9 by default).

AI FinOps

New

Attribute spend by cost center, project, and team; export chargeback CSV; set budget caps; and forecast month-end spend.

Drift Signal

New

Detect behavioral drift — new tool usage, denial-rate shifts, new data classes — and automatically downgrade an agent’s autonomy on high-severity drift.

IAM Binding (Workload Identity)

New

Bind agents to Microsoft Entra workload identities and exchange Entra-issued tokens for short-lived Execlave credentials — no static API keys to rotate or leak.

Enforcement Bypasses

New

What happens when an SDK cannot get an enforcement decision, how each ungoverned stretch is recorded as an enforcement.bypassed audit entry, and how it appears in the signed compliance report.

Effect Confirmation

New

The fourth outcome: the target accepted the request but nobody saw it happen. effectEvidence, the effect_unconfirmed status, resolutions that never rewrite the trace, outcome strictness, the unconfirmed queue, read-back checks, and coverage in the signed report.

Model-Judged Rules

New

Policies in your own words, judged by the deployment’s model after each action: monitor and warn only, every action recorded as violation, no violation or not judged, examples checked before saving, and the model qualified on labelled actions before it may judge.

§ 04

Observability & Incidents

§ 05

Security & Compliance

§ 06

Integrations

§ 07

Reference

§ 08

Quick Reference

EndpointMethodDescription
POST /api/v1/agentsRESTRegister a new AI agent
PATCH /api/v1/agents/:id/pauseRESTKill switch — pause an agent
POST /api/v1/agents/authorizeRESTAgent-to-agent authorization check
POST /api/v1/policiesRESTCreate a governance policy
POST /api/v1/policies/enforceRESTPre-execution policy enforcement
POST /api/v1/policies/testRESTDry-run policy test
POST /api/v1/policies/generate-from-textRESTAI-generated policy from natural language
POST /api/v1/traces/ingestRESTSubmit execution traces (batched, up to 100)
GET /api/v1/traces/:id/treeRESTGet hierarchical trace tree
POST /api/v1/webhooksRESTRegister a webhook endpoint
POST /api/v1/webhooks/:id/testRESTSend a test delivery
POST /api/v1/alerts/rulesRESTCreate an alert rule
GET /api/v1/alerts/historyRESTView alert history
GET /api/v1/incidentsRESTList incidents
GET /api/v1/approvals/pendingRESTList pending approvals
POST /api/v1/approvals/:id/decideRESTApprove or deny an action
GET /api/v1/compliance/reportRESTGenerate compliance evidence report
GET /api/v1/audit-logs/chain/verifyRESTVerify audit log chain integrity
POST /api/v1/anomaly/detectRESTRun anomaly detection
POST /api/v1/anomaly/forecastRESTRun time-series forecast
POST /api/v1/custom-validatorsRESTRegister a BYOV endpoint
GET /api/v1/analytics/overviewRESTOperational analytics overview
§ 09

Install

JavaScript / TypeScript

npm install @execlave/sdk

Python

pip install execlave-sdk

CLI (npm)

npm install -g @execlave/cli

CLI (login)

execlave login
Documentation — Execlave Docs