# Personal tokens

Personal access tokens provide Cortex users with a way to access data and edit entities and Scorecards.

Similar to API keys, you can use personal tokens to make calls through API endpoints. **Permissions for personal tokens directly mirror your own user** [**permissions**](/configure/settings/managing-users/permissioning.md).

All users, including users with the `Viewer` role, can create a personal token.

{% hint style="warning" %}
If you attempt to make a call through endpoints not within your user permissions, this will result in a 403 error.
{% endhint %}

**To create a personal access token**:

1. From the main sidebar, click your avatar in the bottom-left corner.
2. Click **Settings**.
3. From the **Settings** menu, locate the *Preferences* section, then select **My access tokens**.
4. In the upper-right corner, click **Create new token**.
5. Do the following:

   1. Below **Name**, enter a name for the token (required).
   2. Below **Description**, enter a brief overview of the token.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>As a best practice, include details about what the token is used for. If you add multiple tokens, the description can help clearly identify and differentiate between the tokens listed on this page.</p></div>

   3\. Below **Expiration date**, set an expiration date for the token. The key automatically expires at the end of the chosen day based on the current time zone.
6. Click **Create token**.\
   The personal access token is created.


---

# 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://docs.cortex.io/configure/settings/api-keys/personal-tokens.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.