Skip to content

Control Plane V1 Contract

The versioned spec between the control plane runtime and project repos.

What’s in this spec

OpenAPI Reference

Interactive reference for all V1 REST endpoints — projects, runs, queue, webhooks, observability, and SSE streams. View →

Manifest Schema

JSON Schema for .claude/project.yml — the per-project config that tells the control plane how to run a project. View →

Skills Contract

The versioned skill names a project manifest can reference, and what each skill expects the executor to do. View →

Executor Protocol

The interface every executor implements to receive a task, stream events, and report completion. View →

Live endpoints

The V1 API is served live at api.cp.martindev.io.

ResourceURL
OpenAPI JSONhttps://api.cp.martindev.io/v1/openapi.json
Health checkhttps://api.cp.martindev.io/v1/api/health

Versioning

This is the v1 contract directory. Future major versions live alongside (v2/, v3/) and are served in parallel. Migration guides for major bumps live in spec/migrations/. See docs/SPEC_VERSIONING.md for the full rules.