# 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" style="color:$primary;">: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="/pages/HFA3jVjmrz3O2R75BeJt">/pages/HFA3jVjmrz3O2R75BeJt</a></td></tr><tr><td><h4><i class="fa-code-pull-request" style="color:$primary;">: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="/pages/i72xaIxW8cTkk7fD37q8">/pages/i72xaIxW8cTkk7fD37q8</a></td></tr><tr><td><h4><i class="fa-square-terminal" style="color:$primary;">: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="/pages/2pGUVtmu24AahOySc2dA">/pages/2pGUVtmu24AahOySc2dA</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://run-ai-docs.nvidia.com/multi-tenant-api/2.24/nvidia-run-ai-multi-tenant-rest-api-documentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.