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.
Open your profile
In the Control Panel, open your profile and go to API tokens.
Choose scopes and an expiry
Tick the scopes the token needs and choose when it expires.
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 |
A token made before scopes and expiry were offered keeps every scope and does not expire.
Send the token
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 |
403 | reason: two_factor_required | Your company requires two-factor authentication and you have not set it up; see Two-factor authentication |
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.
Was this helpful?