Skip to main content

Endpoints

All paths are under https://app.aiagentlens.com/api. This is a map, not a full reference; each endpoint returns the same shapes the dashboard renders.

Organisation

Method and pathPurpose
GET /orgThe current organisation and plan.
GET /org/members, POST /org/members, DELETE /org/members/{id}List, invite and remove members.
GET/PUT /org/enforcement-modeRead or set enforce / audit-only (admins).
GET /org/plan, GET /plansCurrent plan and the plan catalogue.
GET /dashboardThe numbers on the Overview page.

Agents

Method and pathPurpose
GET /agents, GET /agents/statsFleet list and summary.
GET /agents/selfThe calling agent's own record (agent token).
POST /heartbeatLiveness, hooks and policy version from an agent.
GET /agent/config, GET /policy, GET /policy/yamlPolicy pulled by an agent.
GET /packs, GET /packs/{name}Rule pack download for entitled plans.
POST /eventsAudit event ingestion from an agent.

Audit and posture

Method and pathPurpose
GET /audit, GET /audit/stats, GET /audit/mcp-serversAudit log, counts, and the MCP servers observed.
GET /posture/evidence, GET /posture/control-evidenceAttestations per framework and per control.
GET /posture/attestation-chainHash-chain verification for a window.
GET /posture/driftDeclared versus observed MCP capabilities.

Compliance

Method and pathPurpose
GET /compliance/frameworks, POST /compliance/frameworks, POST /compliance/frameworks/disableEnabled frameworks.
GET /compliance/rules, GET /comply/rulesRules and their control mappings.
POST /compliance/scans, GET /compliance/scans/latest, /history, /detail, /projectsComply scan ingestion and retrieval.
GET /compliance/statusCoverage summary.

Policy checks

Method and pathPurpose
POST /policy/checkEvaluate a command against the organisation's policy (agent token).
POST /playground/analyzePublic evaluation against community rules.