CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 2 of 12

Authentication

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

On this page

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 the token needs and choose when it expires.

  3. Copy the token

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

Expiry

ChoiceThe token stops working
7, 30, 90 or 365 daysThat many days after it was made
A dateOn the date you choose
NeverOnly when you delete it

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

StatusBodyCause
401{"message": "Unauthenticated."}No token, a deleted token or an expired token
403reason: scope_requiredThe token lacks a scope; see Scopes
403reason: two_factor_requiredYour company requires two-factor authentication and you have not set it up; see Two-factor authentication
403reason: company_not_enabledYour account has no company that can use Managed Clusters, for example because the company was closed
403reason: pending_orderYour 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.

Was this helpful?
Open in ClaudeOpen in ChatGPT