Skip to main content
The Nasiko server exposes one HTTP API — the same one the CLI, dashboard, and admin tools use. Live spec (annotated routes only): http://localhost:8080/api/openapi.json on a local cluster, Swagger UI at /api/docs. The copy in this docs site is that generated spec. Routes without #[utoipa::path] are documented on the pages below.

​
Authentication

See access control. Strict attribution: Cost attribution.

​
Conventions

Responses are JSON objects. Errors use HTTP status plus { "error", "code" }. Field names are snake_case. IDs are UUIDs. There is no /api/v1 prefix — evolution is additive.

​
Hand-written surfaces

These are not in the generated OpenAPI file:

LLM router (/v1)

Chat Completions, Responses, Messages, Gemini, embeddings.

Coding agents

Register integrations and ingest telemetry.

Approvals (HITL)

Pending, resolve, cancel, stream, requeue.

OCI registry (/v2)

Embedded Distribution v2 for agent images.
TokenOps extra routes (finops/spend-timeseries, spend-calendar, attributions, /api/usage/*) are listed in cost attribution. MCP management routes are in the generated spec and in MCP gateway. Custom providers: Providers.