# NVIDIA Run:ai Network Topologies API

**Canonical:** https://apis.io/apis/runai/runai-network-topologies-api/  
**Provider:** NVIDIA Run:ai — https://apis.io/providers/runai/  
**Base URL:** https://app.run.ai  
**Documentation:** https://run-ai-docs.nvidia.com/api/readme.md

NVIDIA Run:ai Network Topologies API is one of 62 APIs that [NVIDIA Run:ai](https://apis.io/providers/runai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Network Topologies. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

The Network Topologies API enables administrators to reflect the hierarchical network topology connectivity of nodes in a data center, such as racks, blocks, and other organizational units, to improve pod scheduling decisions for communication-intensive AI/ML workloads. To support topology-aware scheduling, this API allows administrators to define a multi-level network topology element using ordered Kubernetes node labels that represent the network connectivity of nodes in the data center. Nodes are labeled with the same key-value pairs labels that represent their location in the data center network. These labels are used by the NVIDIA Run:ai Scheduler to prefer scheduling pods on nodes that are "closer" to each other, minimizing communication overhead and optimizing workload performance.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/runai/refs/heads/main/openapi/runai-network-topologies-api-openapi.yml
- **Documentation** — https://run-ai-docs.nvidia.com/api/getting-started/about-the-rest-api.md
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/runai/refs/heads/main/authentication/runai-authentication.yml

## Other NVIDIA Run:ai APIs (12)

- [NVIDIA Run:ai Access Keys API](https://apis.io/apis/runai/runai-access-keys-api/)
- [NVIDIA Run:ai Access rules API](https://apis.io/apis/runai/runai-access-rules-api/)
- [NVIDIA Run:ai Administrator Command Line Interface API](https://apis.io/apis/runai/runai-administrator-command-line-interface-api/)
- [NVIDIA Run:ai AI Applications API](https://apis.io/apis/runai/runai-ai-applications-api/)
- [NVIDIA Run:ai Applications API](https://apis.io/apis/runai/runai-applications-api/)
- [NVIDIA Run:ai AuditLogs API](https://apis.io/apis/runai/runai-auditlogs-api/)
- [NVIDIA Run:ai Clusters API](https://apis.io/apis/runai/runai-clusters-api/)
- [NVIDIA Run:ai Compute API](https://apis.io/apis/runai/runai-compute-api/)
- [NVIDIA Run:ai ConfigMap API](https://apis.io/apis/runai/runai-configmap-api/)
- [NVIDIA Run:ai Credentials API](https://apis.io/apis/runai/runai-credentials-api/)
- [NVIDIA Run:ai Datasources API](https://apis.io/apis/runai/runai-datasources-api/)
- [NVIDIA Run:ai Datavolumes API](https://apis.io/apis/runai/runai-datavolumes-api/)

## Tags

Network Topologies

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/runai/runai-network-topologies-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/runai/.