API Reference

Every endpoint of the v1 API — parameters, response examples, a copyable curl, and a console that runs the real call with your own key.

The API is read-only over your verified model, with a small write surface for AI-governance records. Every request is authenticated with an API key and scoped to the organization that key belongs to. The prose introduction lives in API & MCP; this page is the endpoint-by-endpoint reference.

💡

The machine-readable description is at /api/v1/openapi.json — an OpenAPI 3.1 document you can import into Postman or Insomnia, or feed to a client generator.

Base URL …/api/v1OpenAPI 3.1 document Your API keys

API key — to send real requests from this page

Kept in this browser tab only (sessionStorage) and sent to nothing but this API. Close the tab and it is gone. Without a key you still get every example and a copyable curl.

Index

Discovery and key check.

Assessments

Read the verified model: assessments, behaviours, governed context, drift.

AI governance

Record what your own AI systems did, and what AI exposure a floor scan found.

MCP

The same model for copilots that speak the Model Context Protocol. Point an MCP client at /api/mcp with the same API key.

{
  "mcpServers": {
    "daritas": {
      "url": "https://daritas.com/api/mcp",
      "headers": { "Authorization": "Bearer dk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

list_assessments—List the assessments in your organization.

get_assessmentassessment_idOne assessment: system, latest version, counts, confidence.

get_behavioursassessment_idGrounded behaviours with evidence, confidence and review status.

get_contextassessment_idThe governed context pack — verified facts, known-unknowns, usage policy.

get_changesassessment_idDrift between the two latest baselines, including invalidated sign-offs.