Orchestration Engine — OpenAPI

The orchestration engine is the core agent execution service. It provides the richest API surface in AEGIS, covering agent execution, conversations, compliance, checklists, artifacts, rules, and workspaces.

Accessing the Spec


Swagger UI	http://localhost:8001/docs
ReDoc	http://localhost:8001/redoc
OpenAPI JSON	http://localhost:8001/openapi.json

These URLs access the service directly (port 8001), bypassing the API gateway. In production, use the gateway at port 8000.

Route Groups

Prefix	Description	Route File
`/execute`	Agent pipeline execution	`main.py`
`/conversations`	Conversation CRUD + streaming	`conversation_routes.py`
`/projects`	Project containers + knowledge files (R40.5)	`conversation_routes.py`
`/compliance`	Summary, matrix, domains, charts, assessment	`compliance/routes.py`
`/checklists`	Checklist CRUD, items, submit/reject	`compliance/checklist_routes.py`
`/checklists/{id}/items/{idx}/artifacts`	Artifact management	`compliance/artifact_routes.py`
`/workspaces`	Workspace assess, stream, agent	`compliance/workspace/routes.py`
`/eval`	Expert verdict capture (R40a) + eval runs (R40b)	`eval/`

Key Models

Explore the Swagger UI for full Pydantic model schemas including ExecuteRequest, ExecuteResponse, StreamEvent, ComplianceMatrixRow, ChecklistDetail, and WorkspaceEvent.

Rule lifecycle (rule versions, changes, monitoring) moved to the agent-config-service in R31b, served under the /api/v1/rules/* gateway routes — it is no longer served by the orchestration engine. (The internal /rules/evaluate and /rules/condition/evaluate calls are service-to-service only and are 404 at the gateway.)