- Task
- Version ยท 6.0.2
- Manage
Review access tokens in your workspace
Last updated: November 17, 2026
Find every personal access token and service token in your workspace, see who owns each one and when it was last used, and spot the tokens that need attention.
Before you begin
You must have the View access tokens permission, which members of the Administrators group have. Without it, Access Tokens does not appear under Administer.
Procedure
Open the Access tokens page
In Liquibase Secure server, go to Administer > Access Tokens. The Access tokens page lists every access token in the workspace, both personal access tokens and service tokens. Tokens that no longer work stay in the list with their status, so the list is also a history.
Note: When personal access tokens are turned off for the workspace, the page shows Personal access tokens are turned off for this workspace. above the list, and every personal access token is suspended. Turn personal access tokens on or off explains the setting.
Choose which type of token to list
Select one of the tabs. Each tab shows how many tokens it holds:
All tokens: Lists service tokens and personal access tokens together, least recently used first. This is the list to work through when someone leaves or a pipeline is retired.
Service tokens: Lists the token that each service principal holds. Service tokens do not expire.
Personal access tokens: Lists the tokens people created for their own machines. Only the owner of a personal access token can create one.
Narrow the list
Use the controls above the table to find specific tokens:
Search: Type in the Search name, prefix or owner box to match a token's name, its prefix, or its owner.
Owner: Choose a person or a service principal. The first option is All owners, All service principals, or All people, depending on the tab.
Status: Choose All statuses, Active, or Revoked, expired, suspended.
The page shows how many of the tab's tokens match.
Note: To start from a person instead, go to Administer > Users & Access. The Tokens column shows how many active or inactive personal access tokens each person has, or None. Select the count to open the Access tokens page filtered to that person's personal access tokens.
(Optional) Show only the tokens that need attention
Select Needs attention. The button shows how many tokens on the current tab need attention. A token needs attention when it is active and one of these is true:
It has not been used for more than 60 days, or it has never been used and was created more than 60 days ago.
It expires within 14 days.
In the table, the Last used date of an idle token is marked stale, and the Expires date of a token close to its expiry is marked expiring.
Read a token's row
Each row describes one token. There is no separate page for a single token, so the row holds everything the workspace records about it:
Token: The token's name, with its prefix below it. The prefix is
liq_followed by the first 6 characters of the token, which identifies the token without revealing it. Tokens created before Liquibase Secure 6.0.2 show a shorter prefix.Type: Personal access token or Service token.
Owner: The person or service principal the token belongs to. A token whose owner was deleted shows Deleted user.
Status: The token's status, which is active, suspended, revoked, or expired. A note under the status says why a token stopped working, such as
Revoked by an administrator,Owner deactivated, orWorkspace setting off.Created: The date the token was created, and who created it.
Last used: The date the token was last used, or Never. Select the Last used heading to switch between least recent first and most recent first.
Expires: The token's expiry date and how many days are left, or Never for a service token.
How access tokens work in Liquibase Secure explains what each status means and what causes it.
(Optional) Group tokens by owner
Select Group by owner. Each owner gets a header row with their name, a Person or Service principal label, and how many of their tokens are active. A service principal's row has a Details button. A person's row has a Revoke all button when they have tokens you can revoke.