create a static API token for your org
Creates a long-lived static API token. By default (token_identity “service_account”) each token gets its own dedicated service account and only grants access to the current org; the role param controls the token’s permissions (any role assignable to API tokens; see GET /v1/roles?context=api_token) and defaults to org_read_only. With token_identity “personal” the token is issued against your own account instead: it uses your account’s existing roles, is not limited to the current org, and the role param must be empty.
Authorizations
Type "Bearer" followed by a space and token.
Body
Input
human-friendly name to identify the token later
defaults to one year
org role granted to the token. must be assignable to API tokens; see GET /v1/roles?context=api_token. defaults to org_read_only. must be empty for personal tokens.
"service_account" (default) creates a dedicated service account with the given role; "personal" issues the token against your own account and its existing roles, across all your orgs.