Update a personal access token

Updates the specified personal access token by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

PATCH/v3/personal-access-tokens/{id}

JWT

personalAccessToken:write

Parameters

Name	Type	In	Description
id*	string	path	Unique identifier for the personal access token.

Request Body Schema

Property	Type	Description	Constraints
revoked*	boolean	Set true to revoke the token.

Request Example

{
  "revoked": true
}

Triggers webhook: personalAccessToken.updated

POST <your-webhook-url>
{
  "event": "personalAccessToken.updated",
  "data": {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "name": "string",
    "expiresAt": "2019-08-24T14:15:22Z",
    "revoked": true,
    "scopes": [
      "string"
    ],
    "userId": "string",
    "user": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "firstName": "string",
      "lastName": "string",
      "email": "string",
      "role": "string",
      "twoFactorEnabled": true,
      "googleSsoEnabled": true,
      "lastLoginAt": "2019-08-24T14:15:22Z",
      "company": "string",
      "allowCustomerPortalAccess": true,
      "roles": [
        "string"
      ],
      "lastSeenAt": "2019-08-24T14:15:22Z",
      "organizationId": "string",
      "organization": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "address": {
          "addressLine1": "string",
          "addressLine2": "string",
          "city": "string",
          "state": "string",
          "country": "string",
          "postalCode": "string"
        },
        "resellerId": "string",
        "reseller": {
          "id": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "name": "string",
          "email": "string",
          "description": "string",
          "allowedUsers": 0,
          "allowedOrganizations": 0
        }
      },
      "resellerId": "string",
      "reseller": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "allowedOrganizations": 0
      },
      "metadata": [
        {
          "id": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "key": "string",
          "value": "string",
          "viewPermissions": [
            "activation"
          ],
          "visible": true
        }
      ],
      "tags": [
        "string"
      ],
      "emailPreference": {
        "metrics": true
      }
    },
    "lastUsedAt": "2019-08-24T14:15:22Z",
    "lastRotatedAt": "2019-08-24T14:15:22Z"
  },
  "triggeredAt": "string"
}

Responses

200

400

401

403

404

429

500

200 OK

{
  "id": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "name": "string",
  "expiresAt": "2019-08-24T14:15:22Z",
  "revoked": true,
  "scopes": [
    "string"
  ],
  "userId": "string",
  "user": {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "name": "string",
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "role": "string",
    "twoFactorEnabled": true,
    "googleSsoEnabled": true,
    "lastLoginAt": "2019-08-24T14:15:22Z",
    "company": "string",
    "allowCustomerPortalAccess": true,
    "roles": [
      "string"
    ],
    "lastSeenAt": "2019-08-24T14:15:22Z",
    "organizationId": "string",
    "organization": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "email": "string",
      "description": "string",
      "allowedUsers": 0,
      "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "state": "string",
        "country": "string",
        "postalCode": "string"
      },
      "resellerId": "string",
      "reseller": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "allowedOrganizations": 0
      }
    },
    "resellerId": "string",
    "reseller": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "email": "string",
      "description": "string",
      "allowedUsers": 0,
      "allowedOrganizations": 0
    },
    "metadata": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "key": "string",
        "value": "string",
        "viewPermissions": [
          "activation"
        ],
        "visible": true
      }
    ],
    "tags": [
      "string"
    ],
    "emailPreference": {
      "metrics": true
    }
  },
  "lastUsedAt": "2019-08-24T14:15:22Z",
  "lastRotatedAt": "2019-08-24T14:15:22Z"
}