# NVIDIA Run:ai Multi-Tenant REST API Documentation

The NVIDIA Run:ai Multi-tenant REST API provides a programmatic interface for managing and operating multi-tenant NVIDIA Run:ai environments.

In a multi-tenant deployment, a single NVIDIA Run:ai control plane is shared across multiple tenants, each with isolated resources, users, and workloads. The Multi-tenant REST API enables centralized management of this shared control plane, allowing platform operators to automate and control tenant-level and system-level operations.

Typical use cases include:

* Creating and managing tenants
* Registering and managing clusters
* Assigning access, roles, and permissions across tenants
* Auditing system-level activity and operational events

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-gear-code">:gear-code:</i></h4><p><strong>About the REST API</strong><br>Overview of the NVIDIA Run:ai REST API, structure, and core concepts</p></td><td><a href="getting-started/about-the-rest-api">about-the-rest-api</a></td></tr><tr><td><h4><i class="fa-code-pull-request">:code-pull-request:</i></h4><p><strong>API Access Setup</strong><br>Create and use access tokens to authorize API requests</p></td><td><a href="getting-started/api-access-setup">api-access-setup</a></td></tr><tr><td><h4><i class="fa-square-terminal">:square-terminal:</i></h4><p><strong>Using the REST API</strong><br>Make your first requests and learn common request, response, and pagination patterns</p></td><td><a href="getting-started/using-the-rest-api">using-the-rest-api</a></td></tr></tbody></table>