HTTP OpenAPI
HTTP OpenAPI
Control-plane 8090 HTTP API organized by scenario—namespaces, services, instances, config, and governance.
The HTTP API is served by api-http on port 8090. Pick a scenario below. Each page uses a parameters-left / examples-right layout.
Scenario index
| Scenario | Notes |
|---|---|
| Authentication | |
| Login & status | Login / system |
| Users | User CRUD and tokens |
| Groups | User-group CRUD |
| Roles | Role CRUD |
| Policies | Policies and authorization |
| Admin APIs | Ops management APIs |
| Namespaces | Environment namespaces |
| Services | |
| Services · Basics | Service CRUD |
| Services · Contracts | Contracts and reporting |
| Services · Topology | Subscribers / call relations |
| Services · Instances | Instance register and manage |
| Config | |
| Config groups | Config groups |
| Config files | File read/write |
| Config gray | normal / gray publish |
| Config templates | Config templates |
| Governance | |
| Routing | Route rules |
| Rate limit | Rate-limit rules |
| Circuit breaker | Circuit-breaker rules |
| Fault detect | Active probing |
| Lane | Lane rules |
| Lossless | Lossless rules |
| Traffic security | Call authorization |
| Traffic mirror | Mirror rules |
| Traffic mock | Mock rules |
| AI Registry | |
| MCP Registry | MCP Server / Tool |
| A2A Registry | A2A Agent / Skill |
| Client APIs | Discover / Register / pull config |
Conventions
| Item | Notes |
|---|---|
| Base URL | http://127.0.0.1:8090 |
| Management auth | Authorization (token from login) |
| Feature gates | api-http.api.{console,client,admin,aimcp,aia2a} |
| Write bodies | Usually a protobuf message array [{...}]; docs list the full per-item field tree (nested children) |
| Nested shapes | rules / routing_config / health_check etc. are expanded from specification; Any lists unpackable messages by policy |
| Response fields | Write APIs also list entity response field trees; sample JSON is on the right |
Parameters and paths follow control-plane httpserver Enrich annotations and specification protos; the running server is authoritative.