Add

POST
/user
/tokens

Adds a new personal access token.

Warning

You can't create tokens with scopes higher than those in the authorization token.

Hint

If there are any IP or workspace restrictions saved in the authorization token, they will be copied to the created token. If you want to change the restrictions, an authorization token without restrictions must be used.

Request

REQUIRED SCOPES

TOKEN_MANAGE

POST PARAMETERS

namerequired string

The token name.

expires_inoptional integer

Specifies the number of days in which the access token expires. Once specified, expires_at can't be set.

expires_atoptional DateTime

Specifies the expiration period for the token. Once specified, expires_in can't be set.

scopesoptional string[]

The list of scopes for the created token. All scopes are available here.

ip_restrictionsoptional string[]

The list of IP addresses for which the token will be restricted (wildcards are supported).

workspace_restrictionsoptional string[]

The list of workspaces in which the token can be used. A domain must be provided, not workspace name.

Last modified on Sep 23, 2024

Delete Get token by ID

{
  "name": "My test token",
  "expires_in": 7,
  "scopes": [
    "WORKSPACE"
  ],
  "ip_restrictions": [
    "123.123.123.123"
  ],
  "workspace_restrictions": [
    "buddy"
  ]
}

{
  "url": "https://api.buddy.works/user/tokens/ZGU2Mk5ODItMTczYy00MThkLWJiOGtNmJmzFjMWVlYjAy",
  "html_url": "https://app.buddy.works/api-tokens/details/ZGU2Mk5ODItMTczYy00MThkLWJiOGtNmJmzFjMWVlYjAy",
  "id": "ZGU2Mk5ODItMTczYy00MThkLWJiOGtNmJmzFjMWVlYjAy",
  "name": "My test token",
  "token": "ed0f8927-c116-4afe-b555-c888dfd86c92",
  "expires_at": "2023-03-28T13:46:39.238118Z",
  "scopes": [
    "WORKSPACE"
  ],
  "ip_restrictions": [
    "123.123.123.123"
  ],
  "workspace_restrictions": [
    "buddy"
  ]
}