API
  1. Profile
  2. Personal access tokens

Get a personal access token

get
https://api.linode.com//profile/tokens/

Returns a single personal access token.

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: view_profile_pat

  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: account:read_only

CLI

linode-cli profile token-view 123

Learn more

Path Params
string
enum
required

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

Allowed:
integer
required

The ID of the token to access.

Responses

Response body
object
date-time

Filterable, Read-only The date and time this token was created.

date-time

Read-only 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.

integer

Read-only This token's unique ID, which can be used to revoke it.

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.

string

Read-only 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 Linode CLI, require tokens with access to *. Tokens with more restrictive scopes are generally more secure.

string

Read-only 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.

Updated 29 days ago

Did this page help you?
Language
Credentials

Updated 29 days ago

Did this page help you?