# Applications

This section explains the procedure to manage your organization's applications.

Applications are used for API integrations with NVIDIA Run:ai. An application contains a client ID and a client secret. With the client credentials, you can obtain a token as detailed in [API authentication](https://run-ai-docs.nvidia.com/api/2.23/getting-started/how-to-authenticate-to-the-api) and use it within subsequent API calls.

Applications are assigned with [access rules ](https://run-ai-docs.nvidia.com/self-hosted/2.23/infrastructure-setup/authentication/accessrules)to manage permissions. For example, application **ci-pipeline-prod** is assigned with a **Researcher** role in **Cluster: A**.

{% hint style="info" %}
**Note**

You can also create your own user applications for API integrations with NVIDIA Run:ai. See [User Applications](https://run-ai-docs.nvidia.com/self-hosted/2.23/settings/user-settings/user-applications) for more details.
{% endhint %}

## Applications Table

The Applications table can be found under **Access** in the NVIDIA Run:ai platform.

The Applications table provides a list of all the applications defined in the platform, and allows you to manage them.

<figure><img src="https://254436074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfvuZQSF7VCx1Azh0LF0H%2Fuploads%2Fgit-blob-35b36e3de509963a5e16827daf5045164d2a33d5%2Fapplications-new.png?alt=media" alt=""><figcaption></figcaption></figure>

The Applications table consists of the following columns:

| Column         | Description                                        |
| -------------- | -------------------------------------------------- |
| Application    | The name of the application                        |
| Client ID      | The client ID of the application                   |
| Access rule(s) | The access rules assigned to the application       |
| Last login     | The timestamp for the last time the user signed in |
| Created by     | The user who created the application               |
| Creation time  | The timestamp for when the application was created |
| Last updated   | The last time the application was updated          |

### Customizing the Table View

* Filter - Click ADD FILTER, select the column to filter by, and enter the filter values
* Search - Click SEARCH and type the value to search by
* Sort - Click each column header to sort by
* Column selection - Click COLUMNS and select the columns to display in the table
* Download table - Click MORE and then Click Download as CSV. Export to CSV is limited to 20,000 rows.

## Creating an Application

To create an application:

1. Click **+NEW APPLICATION**
2. Enter the application’s **name**
3. Click **CREATE**
4. Copy the **Client ID** and **Client secret** and store them securely
5. Click **DONE**

{% hint style="info" %}
**Note**

The client secret is visible only at the time of creation. It cannot be recovered but can be regenerated.
{% endhint %}

## Adding an Access Rule to an Application

To create an access rule:

1. Select the application you want to add an access rule for
2. Click **ACCESS RULES**
3. Click **+ACCESS RULE**
4. Select a **role**
5. Select up to 10 **scopes** where the access rule will apply
6. Click **SAVE RULE**
7. Click **CLOSE**

## Deleting an Access Rule from an Application

To delete an access rule:

1. Select the application you want to remove an access rule from
2. Click **ACCESS RULES**
3. Find the access rule assigned to the user you would like to delete
4. Click on the trash icon
5. Click **CLOSE**

## Regenerating a Client Secret

To regenerate a client secret:

1. Locate the application you want to regenerate its client secret
2. Click **REGENERATE CLIENT SECRET**
3. Click **REGENERATE**
4. Copy the **New client secret** and store it securely
5. Click **DONE**

{% hint style="warning" %}
**Important**

Regenerating a client secret revokes the previous one.
{% endhint %}

## Deleting an Application

1. Select the application you want to delete
2. Click **DELETE**
3. On the dialog, click **DELETE** to confirm

## Using API

Go to the [Applications](https://run-ai-docs.nvidia.com/api/2.23/authentication-and-authorization/applications), [Access rules](https://run-ai-docs.nvidia.com/api/2.23/authentication-and-authorization/access-rules) API reference to view the available actions.


---

# 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/self-hosted/2.23/infrastructure-setup/authentication/applications.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.
