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`
`/compliance`	Summary, matrix, 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`
`/compliance/rules`	Rule versions, changes, monitoring	`compliance/rule_routes.py`
`/workspaces`	Workspace assess, stream, agent	`compliance/workspace/routes.py`

Key Models

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