API reference

All endpoints are https://<tenant>.api.orkena.com/v1 (or the in-cluster address for VPC / air-gap). Authenticate with a scoped API key or OIDC token. Every mutating call writes a ledger event.

Graphs#

Method	Path	Description
GET	/graphs	List graphs
GET	/graphs/{name}	Get a graph and its versions
POST	/graphs	Create / update a draft
POST	/graphs/{name}/publish	Run the eval gate and publish

Runs#

Method	Path	Description
POST	/runs	Start a run
GET	/runs	List runs (filter by status, workspace, graph)
GET	/runs/{id}	Get run status and steps
POST	/runs/{id}/replay	Deterministic replay
POST	/runs/{id}/fork	Fork from a checkpoint
POST	/runs/{id}/kill	Kill this run

Policies#

Method	Path	Description
GET	/policies	List policy packs
POST	/policies	Create a pack
POST	/policies/{name}/whatif	What-if simulation against past runs
POST	/policies/{name}/activate	Activate a version

Ledger and bundles#

Method	Path	Description
GET	/ledger	Query ledger events (filter by seq, type, actor, date)
POST	/bundles	Create an evidence bundle export
GET	/bundles/{id}	Download the bundle archive

Incident#

Method	Path	Description
POST	/kill	Trigger a kill at agent / graph / workspace / org level (reason required)

Errors#

Errors follow a consistent shape: {"error": {"code": "OrkenaError.XXX", "message": "...", "seq": 417}}. See Error codes.

The full OpenAPI spec will be published and auto-generated post-launch; the twenty endpoints above are hand-curated and stable.