> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tinfoil.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting a Tinfoil admin key

> Step-by-step guide for generating Tinfoil Admin API key for administrative operations

### Step 1: Access Your Dashboard

Log into your Tinfoil account and click the **"Dashboard"** button in the top right corner.

<img src="https://mintcdn.com/tinfoil/V4FchSA2f5FVqQCB/images/admin-key-walkthrough/step-1-access-dashboard.jpeg?fit=max&auto=format&n=V4FchSA2f5FVqQCB&q=85&s=029fb003c1a5393ce149280b017989f8" alt="Tinfoil dashboard" width="2256" height="284" data-path="images/admin-key-walkthrough/step-1-access-dashboard.jpeg" />

### Step 2: Navigate to Admin Tab

Click on the **"Admin"** tab in the dashboard navigation to access the admin key management page.

<img src="https://mintcdn.com/tinfoil/YcLNciQjwT7dbSAU/images/admin-key-walkthrough/step-2-select-admin-tab.jpeg?fit=max&auto=format&n=YcLNciQjwT7dbSAU&q=85&s=e112051b4855ff28c5d26beedc1a17f2" alt="Admin tab selection" width="2458" height="1212" data-path="images/admin-key-walkthrough/step-2-select-admin-tab.jpeg" />

### Step 3: Name Your Admin Key

Enter a name in the **"Key name"** field under **"Create new admin API key"**.

<img src="https://mintcdn.com/tinfoil/YcLNciQjwT7dbSAU/images/admin-key-walkthrough/step-3-name-the-key.jpeg?fit=max&auto=format&n=YcLNciQjwT7dbSAU&q=85&s=71009644d56fbee02dfa09446df517f0" alt="Naming your admin key" width="2462" height="1100" data-path="images/admin-key-walkthrough/step-3-name-the-key.jpeg" />

### Step 4: Create Admin Key

Click the **"Create Admin Key"** button to generate your new admin API key.

<Warning>
  Admin keys provide programmatic access to organization settings, including managing API keys, setting rate limits, and modifying billing configuration.
  Do not share admin keys or expose them in browsers, client-side code, or public repositories.
  Admin keys are automatically revoked when the creator is removed from the organization or demoted from admin.
</Warning>

<img src="https://mintcdn.com/tinfoil/YcLNciQjwT7dbSAU/images/admin-key-walkthrough/step-4-create-admin-key.jpeg?fit=max&auto=format&n=YcLNciQjwT7dbSAU&q=85&s=dc7dc1e0e4528cf87d5f161cf693f3a8" alt="Create admin key button" width="2462" height="1124" data-path="images/admin-key-walkthrough/step-4-create-admin-key.jpeg" />

### Step 5: Copy Your Admin Key

Your new admin key will appear in the list. Click the **copy** button to copy it, or the **eye** button to reveal the full key.

<img src="https://mintcdn.com/tinfoil/YcLNciQjwT7dbSAU/images/admin-key-walkthrough/step-5-copy-view-api-key.jpeg?fit=max&auto=format&n=YcLNciQjwT7dbSAU&q=85&s=87576c8be38321ec4044f1dc9720de8a" alt="Copy or view your admin key" width="2460" height="1206" data-path="images/admin-key-walkthrough/step-5-copy-view-api-key.jpeg" />

### Step 6: Test in Postman (Optional)

You can test your admin key in Postman or any API client. Enter the API endpoint URL, for example:

```
GET https://api.tinfoil.sh/api/billing/usage?time=24h
```

<img src="https://mintcdn.com/tinfoil/V4FchSA2f5FVqQCB/images/admin-key-walkthrough/step-6-postman-url.jpeg?fit=max&auto=format&n=V4FchSA2f5FVqQCB&q=85&s=c6899f8f003a762f3bb130364b2a1079" alt="Postman URL setup" width="832" height="658" data-path="images/admin-key-walkthrough/step-6-postman-url.jpeg" />

### Step 7: Set Bearer Token

In the **Auth** tab, set the type to **Bearer Token** and paste your admin key in the **Token** field.

<img src="https://mintcdn.com/tinfoil/V4FchSA2f5FVqQCB/images/admin-key-walkthrough/step-7-set-bearer-token.jpeg?fit=max&auto=format&n=V4FchSA2f5FVqQCB&q=85&s=937f93e7d57359a0a20be6159f853dc3" alt="Setting Bearer token" width="832" height="658" data-path="images/admin-key-walkthrough/step-7-set-bearer-token.jpeg" />

### Step 8: Get Results

Click **Send** and verify that you get a successful response. The response body contains your usage data.

<img src="https://mintcdn.com/tinfoil/V4FchSA2f5FVqQCB/images/admin-key-walkthrough/step-8-get-results.jpeg?fit=max&auto=format&n=V4FchSA2f5FVqQCB&q=85&s=07aa5bb249fdcd75e9ae0dbf566c82c7" alt="API response results" width="832" height="658" data-path="images/admin-key-walkthrough/step-8-get-results.jpeg" />

## Admin Key Capabilities

Admin keys provide programmatic access to manage your own API keys, query usage metrics, and access billing data. When listing keys, you see all organization keys but only your own keys are returned in full -- keys created by other members are masked.
For complete documentation of available endpoints, see the [Admin API Documentation](/admin/admin-api).