tokens

Overview

Name	Datatype	Description
`id`	`integer`	This token's unique ID, which can be used to revoke it.
`created`	`string`	The date and time this token was created.
`expiry`	`string`	When this token will expire. Personal Access Tokens cannot be renewed, so after this time the token will be completely unusable and a new token will need to be generated. Tokens may be created with "null" as their expiry and will never expire unless revoked.
`label`	`string`	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 scopes this token was created with. These define what parts of the Account the token can be used to access. Many command-line tools, such as the <a target="_top" href="https://github.com/linode/linode-cli">Linode CLI</a>, require tokens with access to `*`. Tokens with more restrictive scopes are generally more secure.
`token`	`string`	The token used to access the API. When the token is created, the full token is returned here. Otherwise, only the first 16 characters are returned.

Name	Accessible by	Required Params	Description
`getPersonalAccessToken`	`SELECT`	`tokenId`	Returns a single Personal Access Token.
`getPersonalAccessTokens`	`SELECT`		Returns a paginated list of Personal Access Tokens currently active for your User.
`createPersonalAccessToken`	`INSERT`		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 is revoked.
`deletePersonalAccessToken`	`DELETE`	`tokenId`	Revokes a Personal Access Token. The token will be invalidated immediately, and requests using that token will fail with a 401. It is possible to revoke access to the token making the request to revoke a token, but keep in mind that doing so could lose you access to the api and require you to create a new token through some other means.
`_getPersonalAccessToken`	`EXEC`	`tokenId`	Returns a single Personal Access Token.
`_getPersonalAccessTokens`	`EXEC`		Returns a paginated list of Personal Access Tokens currently active for your User.
`updatePersonalAccessToken`	`EXEC`	`tokenId`	Updates a Personal Access Token.