> For the complete documentation index, see [llms.txt](https://docs.duplocloud.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplocloud.com/docs/armor/access-control/user-tokens.md).

# User Tokens

This document explains how to create a new API Token in the DuploCloud AI Suite, using the User Tokens tab and the Profile page.

***

## Prerequisites

* Access to the DuploCloud AI Suite admin panel
* An authenticated user account

***

## Step 1 — Navigate to Access Control → User Tokens

Go to **AI Admin → Access Control** in the left-hand navigation. Click the **User Tokens** tab at the top. This lists all existing API tokens with their name, token value, user, created date, last used, expiry, and status.

![Step 1 — User Tokens tab](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-9194a95d8f2d281cecac1b813fd03d59b6c90401%2Fuser-tokens-step-01-user-tokens-tab.png?alt=media)

***

## Step 2 — Click the Profile Icon (Top Right)

In the top-right corner of the page, click the **profile avatar** icon. A dropdown menu appears showing your name and role.

![Step 2 — Profile dropdown](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-1a2042a0210c815c389377014d1a43b56eba5e2d%2Fuser-tokens-step-02-profile-dropdown.png?alt=media)

***

## Step 3 — Click "Profile"

In the dropdown, click **Profile**. This navigates to your Profile page which shows your User Info and the API Tokens table.

![Step 3 — Profile page](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-a3b358fe2da1246ed0963aa3db3f6b55d9f52d05%2Fuser-tokens-step-03-profile-page.png?alt=media)

***

## Step 4 — Click "Create Token"

On the Profile page, locate the **API Tokens** section. Click the **Create Token** button on the right side (shown in purple).

A **Create API Token** modal dialog opens with two fields: Token Name and Expiry Date.

![Step 4 — Create API Token modal](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-4e56032fc3084127b526705e53da0ce01f2bca79%2Fuser-tokens-step-04-create-token-modal.png?alt=media)

***

## Step 5 — Enter a Token Name

Click the **Token Name** field and type a descriptive name for the token.

In this example: `QA-Test-Token`

![Step 5 — Token name filled](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-0d581eb4729e7004ac94f01881af574a216d7d3e%2Fuser-tokens-step-05-name-filled.png?alt=media)

***

## Step 6 — Set the Expiry Date

Click the **Expiry Date** field and enter a future date in `YYYY-MM-DD` format.

> **Important:** The expiry date must be greater than today's date or the form will reject it.

In this example: `2026-04-11` (April 11, 2026)

![Step 6 — Expiry date set](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-470166c922a48ea529bc8007f33b669ee2261528%2Fuser-tokens-step-06-expiry-set.png?alt=media)

***

## Step 7 — Click "Create"

Review the token name and expiry date, then click the **Create** button.

![Step 7 — Ready to submit](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-470166c922a48ea529bc8007f33b669ee2261528%2Fuser-tokens-step-06-expiry-set.png?alt=media)

***

## Step 8 — Copy the Token

A **Token Created** confirmation dialog appears showing the full token value. **Copy the token now** — it will not be shown again.

Click **Copy** to copy it to your clipboard, then click **Close**.

![Step 8 — Token created, copy it now](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fgit-blob-07f62c01c86938eedda666b3ad437f90b65dfab0%2Fuser-tokens-step-09-final-list.png?alt=media)

The new token appears in the API Tokens table with **Active** status and the expiry date you set.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.duplocloud.com/docs/armor/access-control/user-tokens.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.