API Tokens

Delete API token

Changed on

Delete an API token by its ID.

Note: This endpoint accepts a session credential only. An API token is rejected with 401 ERR_API_TOKEN_NOT_ALLOWED; an OAuth access token with 403 ERR_FORBIDDEN.

Note: API Token APIs are available on all cloud-hosted plans, and on licensed self-hosted deployments (Business plan and above).

Beta: These APIs are currently in beta and subject to change in future releases.

delete/api/v3/meta/tokens/{tokenId}

Request

Path parameters

tokenIdstring required
Example:5

ID of the API token to delete

Response

Token deleted

deletedboolean required

Always true — a failed delete is reported as an error status.

Example response

{
  "deleted": true
}

Changes

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      api operation id tokens-delete was added

    • info

      the endpoint scheme security xc-token was removed from the API

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the required property to the response with the status