Manage personal tokens

Create and delete personal tokens from Azion Console or the Azion CLI, and store the token value when you create it.

Last updated

View as Markdown Agent setup

You can create and delete a personal token from Azion Console or with the Azion CLI. A personal token authenticates your requests to the Azion API and the commands you run in the CLI. To revoke a token, delete it.

Select the interface you use. The prerequisites and each procedure on this page follow that choice.

Prerequisites

  • The Azion CLI installed and logged in to your account. To set it up, refer to Azion CLI quickstart.

Create a personal token

Each personal token has a name, an optional description, and an expiration. Azion shows the token value only when the token is created, so store it before you continue.

To create a personal token with the Azion CLI, pass a name, an expiration, and an optional description. This command creates a token named my-token that expires the next day:

azion create personal-token --name my-token --expiration 1d --description 'Token for local CLI tests'

The command prints the token value:

Created Personal Token: [TOKEN VALUE]

The --expiration flag takes a number followed by d for days or m for months, such as 1d or 9m. No other personal-token command prints the value. To create the token from a JSON file with the name, expires_at, and description keys, refer to Azion CLI personal-token.

To create a personal token in Azion Console:

Open the Personal Tokens page

Access Azion Console > Account > Personal Token. Account is the avatar menu.

Select + Personal Token
Name the token

In the General section, enter a Name that identifies the token.

(Optional) Describe the token

In Description, enter what the token is for.

Set the expiration

In the Token section, select a value in Expires within. The default is 1 day. The other values are:

  • 7 days, 15 days, 30 days, or 90 days
  • 1 year
  • Custom Date, which opens a calendar to select the date
Select Save
Copy the token

In the Personal Token has been created dialog, select Copy. The Personal Token field masks the value until you show it.

Select Confirm

The token appears on the Personal Tokens page with its Expiration Date. After the dialog closes, the value cannot be retrieved, and a lost token must be replaced with a new one.

Delete a personal token

Deleting a personal token revokes it, and the deletion cannot be undone. Azion Console asks you to confirm the deletion with the token name, and the Azion CLI takes the token UUID.

The Azion CLI deletes a personal token by its UUID. To find the UUID, list your personal tokens:

azion list personal-token

The command prints the UUID, the name, and the expiration of each token, never its value:

Text
01ID NAME EXPIRES AT
0211111111-2222-4333-8444-555555555555 my-token 2027-01-15 23:59:59 +0000 UTC
0322222222-3333-4444-8555-666666666666 ci-deploy 2026-12-20 23:59:59 +0000 UTC
0433333333-4444-4555-8666-777777777777 cli-local 2027-09-17 23:59:59 +0000 UTC
0544444444-5555-4666-8777-888888888888 old-token 2026-09-11 23:59:59 +0000 UTC

A token past its expiration, such as old-token, stays in the list until you delete it.

To delete the token, pass its UUID in --id. This command deletes the token named my-token:

azion delete personal-token --id 11111111-2222-4333-8444-555555555555

The command deletes the token without asking for confirmation, and prints:

Personal token 11111111-2222-4333-8444-555555555555 was successfully deleted

To delete a personal token in Azion Console:

Open the Personal Tokens page

Access Azion Console > Account > Personal Token. Account is the avatar menu.

Select Delete on the token

In the row of the token, select Delete. The Delete personal token dialog opens.

Enter the token name

In the box of the dialog, enter the name of the token, as the confirmation label quotes it.

Select Delete

The message Personal token successfully deleted appears, and the token no longer shows on the Personal Tokens page.

Next steps

Azion CLI quickstartSave your personal token in the CLI and deploy your first project.Azion API quickstartSend your first requests to the Azion API with your personal token.Azion CLI personal-tokenEvery flag of the commands that create, list, describe, and delete personal tokens.Azion APIThe base URL, the authentication header, and the rate limits of the API.