Create a personal access token

post

https://api.linode.com/{apiVersion}/profile/tokens

Creates a personal access token for your User. The raw token will be returned in the response, but will never be returned again afterward so be sure to take note of it. You may create a token with at most the scopes of your current token. The created token will be able to access your account until the given expiry, or until it's revoked.

Parent and child accounts

In the context of the parent and child accounts feature, delegate users can't use personal access tokens on child accounts. You need to create a delegate user token instead.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

Identity and access permissions. Your user needs a role with these permissions. Learn more.
- Permissions: create_profile_pat
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: account:read_write

CLI

linode-cli profile token-create \
  --scopes '*' \
  --expiry '2018-01-01T13:46:32' \
  --label linode-cli

Learn more

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

Body Params

expiry

date-time | null

When this token should be valid until. If omitted, the new token will be valid until it is manually revoked.

label

string

length between 1 and 100

Filterable This token's label. This is for display purposes only, but can be used to more easily track what you're using each token for.

scopes

string

The access scopes to grant to the created token. These cannot be changed after creation, and may not exceed the scopes of the acting token.

If omitted or entered with a wildcard character (*), the new token will have the same scopes as the acting token.

Multiple scopes are separated by a space character ( ).

For example, linodes:read_write account:read_only.

Responses

200Token created successfully.

defaultSee Errors for the range of possible error response codes.