HTTP Endpoints

Configuration Settings

Setting	Location	Description
`aion.agents`	`aion.yaml`	Agent IDs define `/agents/{agent_id}/...` proxy path prefixes.
`aion.agents.<agent_id>.configuration`	`aion.yaml`	Feeds `/.well-known/configuration.json` metadata.
`aion.http.<mount_path>`	`aion.yaml`	Mounts additional ASGI/FastAPI apps under custom paths.
`--port`	`aion serve`	Sets proxy host port for endpoint access.
`--port-range-start`	`aion serve`	Start of dynamic port range for proxy and agents.
`--port-range-end`	`aion serve`	End of dynamic port range for proxy and agents.

Path	Method	Purpose
`/`	`POST`	JSON-RPC endpoint for A2A requests.
`/.well-known/agent-card.json`	`GET`	Agent card and capability metadata.
`/.well-known/configuration.json`	`GET`	Protocol version and agent configuration metadata.
`/health/`	`GET`	Agent health check.

Path	Method	Purpose
`/health/`	`GET`	Proxy health check.
`/health/system/`	`GET`	Aggregated health for proxy and all agents.
`/.well-known/manifest.json`	`GET`	Manifest with available agent endpoints.
`/agents/{agent_id}/{path}`	`ANY`	Forward request to a specific agent.