Documentation

API

The versioned JSON API is served under /v1. The committed OpenAPI 3.1 document is the source of truth for request and response schemas.

Open the OpenAPI specification →

Core endpoint families

POST /v1/resources
POST /v1/artifacts
POST /v1/artifacts/{artifact}/dependencies
POST /v1/check
POST /v1/invalidate
GET  /v1/impact/{node}
POST /v1/artifacts/{artifact}/revalidate
GET  /v1/events

Protocol guarantees

Mutation retries use Idempotency-Key. Errors contain stable code, message, and request_id fields. Timestamps use RFC 3339 UTC. Unknown JSON fields and multiple request objects are rejected.

Operational endpoints are /healthz, /readyz, and Prometheus-compatible /metrics.