GET
/
api
/
svc
/
v1
/
personal-access-tokens
/
{name}
Get or Create Personal Access Token
curl --request GET \
  --url https://{controlPlaneURL}/api/svc/v1/personal-access-tokens/{name} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "type": "<string>",
    "tenantName": "<string>",
    "manifest": {
      "name": "<string>",
      "type": "virtual-account",
      "expiration_date": "<string>",
      "permissions": [
        {
          "resource_fqn": "<string>",
          "resource_type": "<string>",
          "role_id": "<string>"
        }
      ]
    },
    "createdBySubject": {
      "subjectId": "<string>",
      "subjectType": "user",
      "subjectSlug": "<string>",
      "subjectDisplayName": "<string>"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "isExpired": true,
    "createdBy": "<string>"
  },
  "token": "<string>",
  "created": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
name
string
required

Response

Personal Access Token found successfully and returned with token

​
data
object
required

Personal Access Token data

​
token
string
required

Personal Access Token

​
created
boolean
required

Whether the PAT was created (true) or already existed (false)