Docs / API Reference
Control API
REST API for command submission, queue operations, run inspection, and live control plane changes.
Base URL
https://synaps.your-domain.internal
Authentication
The Control API does not enforce authentication by default. Run it behind a reverse proxy or API gateway that terminates TLS and applies your organization's auth policy.
Content-Type
All request and response bodies are application/json unless otherwise specified.
Core Endpoints
Commands
Submit a new root command into the ledger and queue.
POST /v1/commands/submit
Queue
Claim, renew, and complete queue items.
POST /v1/queue/claim
POST /v1/queue/renew
POST /v1/queue/complete
Runs
Fetch a run with tasks, artifacts, and events.
GET /v1/runs/{runId}
Control Plane
Live mutations to prompts, skills, tools, routes, and arbiters.
POST /v1/control/.../prompts/activate
POST /v1/control/.../skills/register
POST /v1/control/.../routing-rules/update
Full OpenAPI Spec
The canonical specification lives in the Synaps repository. You can download it directly from a running Control API instance or browse the rendered reference below.