The Podium gateway is the external runtime entry point. It authenticates requests, routes them to coordinators, and exposes deployment and instance operations.
Runtime
| Field | Value |
|---|---|
| Default endpoint | SSM-hydrated staging PODIUM_URL |
| Local endpoint | 127.0.0.1:8002 only when FABRIC_PODIUM_MODE=local |
| Public host | https://podium.fabric.dev.aws.igent.ai retained as compatibility |
| Config source | Environment variables |
Route Families
| Route family | Purpose |
|---|---|
| Health | Gateway liveness and readiness |
| Deployments | Upload or reference agent deployment bundles |
| Instances | Create, inspect, stop, and route agent instances |
| Runtime streams | Proxy agent runtime events to the owning coordinator |
| Config/logs | Operational inspection where enabled |
Exact route names can vary between compatibility and Fabric-facing paths. Prefer the checked-in gateway route table when implementing against Podium directly.
Authentication
Gateway calls require a scoped Podium API key. Admin operations require an admin-scoped key. Diminuendo should use a service credential with only the permissions required for runtime brokering.
Boundary
The gateway routes runtime work; it does not own client session state, inference provider routing, or workspace version history.