CALIBER
Quickstart
Reference

REST API resource catalog

The route families mounted under the CALIBER management API, grouped by the domains developers actually integrate with.

DeveloperReferenceGA
PrerequisitesA CALIBER API integration question
Reviewed 2026-08-11 · current main branch docs contract

This page is the domain map for the CALIBER management API. It answers "where does this capability live?" before you drop into per-route details.

Platform and bootstrap

Route familyPurpose
/health, /readinessLiveness and dependency posture
/auth, /csrf, /meAuthentication, token/session plumbing, caller identity
/capabilities, /openapi.json, /settingsSurface discovery, stability metadata, runtime configuration
/dashboard/summaryOverview aggregates used by the UI

Authoring and runtime assets

Route familyPurpose
/promptsPrompt registry, aliases, versions, and refinement-related authoring
/toolsTool registry, tests, calibration, and policy
/skillsSkill registry, versions, packaging, tests, and calibration
/mcp-serversManaged MCP definitions, inventories, connection tests, and governed tool invocation
/workflows, /workflow-components, /workflow-templatesWorkflow registry, composition, and templates
/workflow-versions, /workflow-runs, /workflows/{id}/deploymentsVersion lifecycle, execution, approvals, and deployment
/services and /workflows/{id}/servicePublish a workflow as an external HTTP service, invoke it, and inspect service tokens/OpenAPI

Data, knowledge, and evidence

Route familyPurpose
/projects and project file routesWorkspace/project inventory, effective access metadata, membership management, and managed file registry
/object-store/*Raw bucket/object storage operations
/knowledge-bases, /knowledge-base-versions, /knowledge/queryRAG corpora, versions, graph state, and retrieval
/eval-datasetsDatasets, examples, trace import, sync, and restore
/evaluationsScored evaluation runs
/judgesModel-backed graders and alignment
/review-queuesHuman review queues and adjudication outputs

Operations and governance

Route familyPurpose
/jobsDurable background jobs and apply targets
/releasesCandidates, evaluation, waivers, signoff, reporting, and reconcile operations
/rollbackShared rollback helpers where an asset family exposes them
/observability/*, /metrics, /events/streamTraces, experiments, metrics, and SSE
/audit-logRead-only audit explorer and export
/gateway/* and /llm-pricingGateway discovery, guardrails, usage, and pricing overrides
/system/services, /system/incidents, /system/effects, /system/webhook-dead-lettersRuntime health and operational recovery surfaces
/secretsWrite-only secret references and lifecycle

Assistant and agentic surfaces

Route familyPurpose
/assistant/*Session-based assistant interactions, drafts, queue, and attachments
/aria/plans, /aria/interactions, /aria/capabilitiesGoal-plan decomposition, approval, execution, polling, and human questions
/cookbooksCookbook catalog and installation

How this maps to the SDK

The SDK guide and SDK API reference wrap the same route families above with typed models, error translation, automatic CSRF handling, and polling helpers. The SDK docs should explain the Python abstraction; this page is the raw route inventory.

Project access routes

Project responses include the caller's effective access_role and a sorted permissions list. The membership endpoints return members objects with the member id, user id, role, active status, and audit timestamps:

RoutePurposeRequired project role
GET /projects/{project_id}/membersList active membersany visible member
POST /projects/{project_id}/membersAdd or reactivate a memberowner
PATCH /projects/{project_id}/members/{user_id}Change role or statusowner
DELETE /projects/{project_id}/members/{user_id}Deactivate a memberowner

Project roles are owner, editor, reviewer, and viewer. These roles are project-level decisions; the caller's bearer-token scope remains a separate global ceiling.

CALIBER : Contextual Adaptive Lifecycle for Intelligent Build, Evaluation, and Refinement — this page is generated from the authoritative Markdown sources in docs/ and the repository-level ARCHITECTURE.md.