> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aion.to/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP Endpoints

> Agent and proxy HTTP endpoints exposed by the Python SDK.

## 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.                |

## Agent Endpoints

| 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.                                |

## Proxy Endpoints

| 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.        |

## Common Proxy Error Responses

| Code  | Meaning                  |
| ----- | ------------------------ |
| `404` | Agent ID was not found.  |
| `503` | Agent is unavailable.    |
| `504` | Agent request timed out. |
| `500` | Proxy forwarding error.  |