Get current token

View as Markdown

GET
/user
/token

Get personal access token used for authorization

Request

REQUIRED SCOPES

USER_PAT_READ

Response

RESPONSE BODY

urlread-onlystring

API endpoint to GET this object

html_urlread-onlystring

Web URL to view this object in Buddy.works

idstring

The ID of the access token

namestring

The name/description of the access token

tokenstring

The actual access token value. Only returned when creating a new token

expires_ininteger

The token expiration time in days

expires_atstring

The token expiration date

scopesstring[]

The array of OAuth scopes granted to the token

Constraints: Unique items required

ip_restrictionsstring[]

The array of IP addresses that are allowed to use this token

workspace_restrictionsstring[]

The array of workspaces for which this token can be used

Last modified on Apr 22, 2026

Delete Emails Get token by ID

Request example

CURL
curl -X GET "https://api.buddy.works/user/token" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json"

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/user/tokens/0123456789abcdef0123456789abcdef0123",
  "html_url": "https://app.buddy.works/api-tokens/details/0123456789abcdef0123456789abcdef0123",
  "id": "0123456789abcdef0123456789abcdef0123",
  "name": "My API Token",
  "expires_at": "2025-10-17T10:30:18.123456789Z",
  "scopes": [
    "WORKSPACE_MANAGE",
    "REPOSITORY_READ"
  ],
  "ip_restrictions": [
    "192.168.1.100",
    "10.0.0.0/8"
  ],
  "workspace_restrictions": [
    "my-workspace"
  ]
}

STATUS
200 OK