---
title: Personal Access Tokens
---

import { APITokensBadges, APITokensQuickStart, APITokensBenefits, APITokensBestPractices } from './APITokensCards';

# Personal Access Tokens

Personal Access Tokens (PATs) are secure credentials that let you authenticate with the TIR AI Platform programmatically — without using your account password. Use them in API calls, CLI tools, scripts, and CI/CD pipelines.

<APITokensBadges />

## Quick Start

<APITokensQuickStart />

---

### Why Use Personal Access Tokens?

<APITokensBenefits />

---

### How to Manage Tokens

#### 1. Access the Tokens Page

<div style={{paddingLeft: '1.5rem'}}>

-  Log in to the **TIR AI Platform**.
-  Navigate to **Security → Personal Access Tokens** from the sidebar.

</div>

---

#### 2. Create a Token

<div style={{paddingLeft: '1.5rem'}}>
- Click **Create Token**.
- Enter a descriptive name (e.g., `ci-pipeline`, `dev-laptop`, `jupyter-integration`).
- Click **Create**.
</div>

<br></br>
:::warning Copy Your Token Immediately
The token value is shown **only once** after creation. Copy and store it securely — in a password manager or as an environment variable. You **cannot** retrieve it again.
:::

---

#### 3. View Active Tokens
<div style={{paddingLeft: '1.5rem'}}>
All tokens appear in the tokens list with their **name** and **creation date**.
</div>
---

#### 4. Delete a Token
<div style={{paddingLeft: '1.5rem'}}>
- Locate the token in the list.
- Click the **Delete** icon next to it.
- Confirm when prompted.
</div>
<br></br>
:::info Token Revocation
Deleting a token **immediately** revokes its access. Any service or script using this token will no longer be able to authenticate.
:::

---

### Using Your Token

- #### In API Requests

Pass your token as a Bearer header in any API call:

```bash
curl -H "Authorization: Bearer <your-token>" \
  https://api.e2enetworks.com/tir/v1/...
```

- #### As an Environment Variable

Set the token as an environment variable to avoid hardcoding it in your code:

```bash
export TIR_API_TOKEN="<your-token>"
```

Then reference it in your scripts:

```python
import os
token = os.environ["TIR_API_TOKEN"]
```

---

### Best Practices

<APITokensBestPractices />


---