AppRegistry - Aion Docs

Use app_registry to mount custom FastAPI routers in the same process as your agent server.

When to Use

Add custom health or diagnostics endpoints.
Expose supplemental API routes used by your integrations.
Keep custom routes close to the agent module that is loaded by aion.yaml.

Routes you register here are not protected by the server’s caller authentication: they are reachable without a token, and no caller is identified for them. If a route must not be public, authenticate its requests yourself. The agent’s own endpoints stay protected; see Caller Authentication.

Example

aion.yaml:

aion:
  agents:
    support:
      path: "./agent.py:build_graph"

agent.py:

from fastapi import APIRouter
from aion.server import app_registry

custom_router = APIRouter(prefix="/api/custom")

@custom_router.get("/health")
async def custom_health():
    return {"status": "ok"}

app_registry.add_router(custom_router)

API

Method	Description
`add_router(router: APIRouter)`	Registers a FastAPI router.
`get_routers()`	Returns all registered routers.