Token Admin documentation on Azure DevOps REST API is not complete

[jrossstocholm]

I am trying to work out how to use the Token Admin "Revoke Personal Access Token" functionality of the Azure DevOps REST API's. However - most of the functionality is not documented in enough detail to understand how to use it.

An example is the page referenced above. It should be possible to revoke a token, but there is not enough documentation for the "Request Body" to understand how. It just says that the body is a string.

I have tried to guess how to use it - one of the guesses was to use this as the body:

[
  {
    "authorizationId": "<GUID authorizationId from existing PAT>"
  }
]

But it throws this error:

{
    "$id": "1",
    "innerException": null,
    "message": "Parameter 'accessTokenKey' cannot be omitted",
    "typeName": "Microsoft.VisualStudio.Services.TokenAdmin.Client.TokenAdminBadRequestException, Microsoft.VisualStudio.Services.WebApi",
    "typeKey": "TokenAdminBadRequestException",
    "errorCode": 0,
    "eventId": 3000
}

Please update the documentation such that it is possible to understand how to use the REST API's.

[welcome[bot]]

Thank you for creating the issue! One of our team members will get back to you shortly with additional information. If this is a product issue, please close this and contact the particular product's support instead (see https://support.microsoft.com/allproducts for the list of support websites).

[rootsmusic]

@jlundstocholm Please move this issue to https://github.com/MicrosoftDocs/azure-devops-docs/issues

[jrossstocholm]

@jlundstocholm Please move this issue to https://github.com/MicrosoftDocs/azure-devops-docs/issues

Done :-)

https://github.com/MicrosoftDocs/azure-devops-docs/issues/11265