Approval Service — OpenAPI

The approval service manages the HITL approval workflow and immutable audit trail.

Accessing the Spec


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

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

Route Prefixes

/approvals — Approval request CRUD, decision recording (approve/reject/modify), and escalation

Key models: ApprovalDetail, ApprovalListResponse, EscalationResponse. The audit trail is append-only with HMAC-signed entries — decisions cannot be modified or deleted after recording.