| Method | Path | Summary | Auth |
|---|---|---|---|
| GET | /v1/nodes | List platform nodes with explicit inventory order and keyset pagination | Session |
| POST | /v1/nodes | Create a pending platform node | Session |
| POST | /v1/nodes/batch-admin-state | Update one administrative state across a batch of nodes | Session |
| GET | /v1/nodes/metrics/latest | Get latest durable load samples for a bounded set of platform nodes | Session |
| GET | /v1/nodes/monitoring/latest | 批量读取节点本机 TCP 探测事实与当前生效策略 | Session |
| GET | /v1/nodes/registration-credential | Get the reusable node registration credential | Session |
| POST | /v1/nodes/registration-credential/reset | Reset the node registration credential | Session |
| GET | /v1/nodes/{id} | Get one platform node | Session |
| PATCH | /v1/nodes/{id} | Update node inventory metadata or administrative state | Session |
| POST | /v1/nodes/{id}/enrollment-tokens | Issue a one-time enrollment token | Session |
| POST | /v1/nodes/{id}/gateway-port-transitions | Start a versioned Agent Gateway communication-port transition | Session |
| GET | /v1/nodes/{id}/gateway-port-transitions/{transition_id} | Get the durable communication-port transition state | Session |
| POST | /v1/nodes/{id}/gateway-port-transitions/{transition_id}/finalize | Finalize a switched Agent Gateway communication port | Session |
| POST | /v1/nodes/{id}/gateway-port-transitions/{transition_id}/rollback | Roll back an Agent Gateway communication-port transition | Session |
| GET | /v1/nodes/{id}/metrics/latest | Get the latest durable load sample for one platform node | Session |
Contract file：api/openapi/v1/control.yaml api/node-monitoring-latest.openapi.yaml