Skip to content

HTTP API

The built-in HTTP surface is intentionally minimal. It is a transport adapter over the same application use cases used by the SDK and CLI.

Endpoints

GET /health

Process liveness.

GET /ready

Runtime readiness. A deployment is ready when at least one configured RuntimeSet validates successfully.

GET /v1/capabilities

Lists available RuntimeSets/language-profile capability data.

POST /v1/validate-request

Validates a canonical request without performing grammatical realization.

POST /v1/explain

Returns planning/runtime diagnostics.

POST /v1/render

Executes the canonical semantic-to-language pipeline.

Error behavior

Semantic/application failures are returned as the stable SA error envelope. Malformed transport/input errors are mapped to SA-REQ-001.

Production note

The built-in server is a thin reference transport. Production deployment may place SA behind another service host or gateway as long as the canonical application contracts remain unchanged.