Cloud Administration Delete Hardware Token API

The Cloud Administration Delete Hardware Token API enables Help Desk Administrators to delete a hardware token record from the Cloud Authentication Service by providing a token serial number. After the record is successfully deleted, the user cannot authenticate with the token.

Authentication

Clients calling this API must authenticate themselves by including a JSON web token in the request. For instructions on using this token, see Authentication for the Cloud Administration APIs.

Administrative Roles

This API can use an API key associated with either Super Administrator or Help Desk Administrator role. For more information, see Manage the Cloud Administration API Keys.

Software Developer Kit

You can download the API Software Developer Kit (SDK) from Cloud Administration REST API Download.

Request Requirements

Use the following information to delete a hardware token record by providing a token serial number.

Method Request URL Response Content Type Response Body Response Codes
DELETE /AdminInterface/restapi/v1/sidTokens/delete application/json Token details with property 200, 403, 404, 500

Example Request Data

The following example displays a request.

DELETE /AdminInterface/restapi/v1/sidTokens/delete

Accept: application/json

Authorization: Bearer <JWT token>

Example Request Body

{

"tokenSerialNumber" : "1231314525"

}

Request Property Descriptions

The following table shows request property descriptions and other associated information.

Property Description Required? Max Length Data Type
tokenSerialNumber The token serial number associated with a user. The number is displayed at the back of the SecurID700 hardware token. Yes 36 String

Response Codes

The following table shows response codes and descriptions for this API.

Code Description
200 Successfully deleted a hardware token assigned to the user.
403 The Help Desk Administrator does not have the permission to delete SecurID700 hardware tokens. Only a Super Administrator can perform this task.
404 Hardware token with serial number is not found.
500 Internal error. The following message is returned: Unable to complete service call.
429 Too many requests.