---
title: "Authentication"
url: https://docs.corefinity.com/api/authentication
type: page
last_updated: 2026-11-13
feature: api
---
# Authentication

Make a personal access token in the Control Panel and send it as a bearer token.

Every request carries a personal access token. A token acts as the person who made it, so it can see and change only what that person can.

## Make a token

Tokens are made in the Control Panel only; there is no endpoint that creates one.

1. **Open your profile**

   In the Control Panel, open your profile and go to **API tokens**.

2. **Choose scopes and an expiry**

   Tick the [scopes](/api/scopes) the token needs and choose when it expires.

3. **Copy the token**

   The token is shown once. Store it in a secret manager.

## Expiry

| Choice                | The token stops working          |
| --------------------- | -------------------------------- |
| 7, 30, 90 or 365 days | That many days after it was made |
| A date                | On the date you choose           |
| Never                 | Only when you delete it          |

> **Note:** A token made before scopes and expiry were offered keeps every scope and does not expire.

## Send the token

```http
GET /api/user HTTP/1.1
Host: manage.corefinity.com
Accept: application/json
Authorization: Bearer <token>
```

## When a token is refused

| Status | Body                              | Cause                                                                                                                        |
| ------ | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `401`  | `{"message": "Unauthenticated."}` | No token, a deleted token or an expired token                                                                                |
| `403`  | `reason: scope_required`          | The token lacks a scope; see [Scopes](/api/scopes)                                                                           |
| `403`  | `reason: two_factor_required`     | Your company requires two-factor authentication and you have not set it up; see [Two-factor authentication](/api/two-factor) |
| `403`  | `reason: company_not_enabled`     | Your account has no company that can use Managed Clusters, for example because the company was closed                        |
| `403`  | `reason: pending_order`           | Your company's first order is not finished; every endpoint refuses until it is                                               |

## Revoke a token

Delete the token under **API tokens** on your profile. Signing out of the Control Panel does not revoke a token.
