Skip to main content

Compile a concept to an execution graph

POST 
/compile

Validate, compile, and store a concept as an ExecutionGraph.

Returns the stored ExecutionGraph with a stable graph_id and ir_hash. The graph is stored in the execution_graphs table and can be retrieved by graph_id via GET /compile/graphs/{graph_id} or executed via POST /execute/graph.

Graph replacement invariant: Recompiling an unchanged definition produces the same ir_hash. If the existing graph has a different ir_hash → HTTP 409.

HTTP 400 — validation errors in concept definition. HTTP 404 — referenced primitive or feature not found. HTTP 409 — ir_hash mismatch on recompile (CompilerInvariantError). HTTP 422 — type errors detected by type checker.

Request​

Responses​

Successful Response