Beta documentation

API and CLI documentation

Machine access for CI pipelines and automation.

Machine API

Project owners mint scoped tokens under /api/projects/:id/tokens (Professional+). Base paths live under /api/v1/projects/:projectId/ for models, specifications, validation jobs, runs, and comparison. Creating a validation returns a durable job; poll /jobs/:jobId until it exposes validation_run_id. Idempotency-Key headers are supported on mutating calls.

CLI

Install via the repository bin: npx aec-validator --help. The CLI uploads a model and specification, waits for the shared durable validation worker, compares against a baseline, and writes JSON/CSV/SARIF artefacts. See examples/ci/ for GitHub Actions, GitLab CI, and Docker samples.