Personal Access Tokens Beta

In Personal Access Tokens under account settings, you can issue and manage PATs (personal access tokens) for operating Codatum from the Codatum CLI.

PATs are issued per workspace. A Workspace Owner can view and revoke PATs issued within the workspace from workspace settings. For details, see the workspace Personal Access Tokens page.

INFO

This feature is in beta. The specification might change without notice.

Prerequisites

• If the workspace policy prohibits using the Codatum CLI, this menu isn't shown
• Workspace guests can't use PATs

Issuing a token

1. Select Issue new token
2. Enter the following, then select Issue

Item	Description
Name	An identifying name for the token
Expiration	You can set this in 1-day increments, up to 365 days (see Limits) (you can't issue a token with no expiration)
Restrict token permissions	By default, a token inherits all of the issuer's permissions. To grant only a subset of those permissions, turn this on and narrow the scope to specific connections, notebooks, or tags. For an overview, see Permissions overview

The plaintext token is shown only once, right after you issue it, and can't be retrieved again. Copy it and store it somewhere safe, and don't share it with anyone else.

For CLI usage instructions, see the Codatum CLI documentation.

Managing tokens

• You can change the name or permission restrictions of a token that hasn't expired
• You can suspend a token that hasn't expired
  • You can resume a suspended token to make it usable again
• You can immediately disable a token that hasn't expired by revoking it
  • Once revoked, a token can't be reactivated
• A token whose expiration has passed becomes expired and is automatically revoked
  • An expired token can't be reactivated
• A Workspace Owner can suspend or revoke any token in the workspace
  • For details, see Personal Access Tokens