Skip to main content

Create Access Token

Create a personal access token, which can be used instead of a password to authenticate to the Magpie CLI or JDBC server.

The token value appears only in this command's output. It is hashed before it is stored, and List Access Tokens never returns it — so if it is not recorded when it is created, it cannot be recovered and the token has to be deleted and replaced. Clearing the notebook paragraph that displayed it afterwards is good practice.

Syntax​

create access token [for <user reference>] [with description "<description>"]

Parameters​

user reference​

Email — The user to create the token for. Omit it to create a token for yourself. Naming another user is only supported for service accounts.

description​

String — A note recording what the token is for. Shown when listing tokens.

Security​

For your own tokens, requires the AccessToken permission on the organization. Organization administrators also qualify — Admin satisfies the same check.

For a service account's tokens, organization administrator is required instead. The AccessToken permission alone does not grant it.