Cloud Administration Delete Hardware Token API
The Cloud Administration Delete Hardware Token API enables Help Desk Administrators to delete a hardware token record from Cloud Access Service (CAS) by providing a token serial number. After the record is successfully deleted, the user cannot authenticate with the token.
For information about managing access to this API, see Accessing the Cloud Administration APIs.
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.
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, 429, 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. |
| 429 | Too many requests. |
| 500 | Internal error. The following message is returned: Unable to complete service call. |
Related Articles
Configure Shipping Addresses for Hardware Authenticators 9Number of Views RSA Hardware Authenticators 610Number of Views Registering RSA SID 700 hardware tokens in Microsoft Entra ID 152Number of Views Transfer SecurID 700 Hardware Token Ownership to Cloud Authentication Service 279Number of Views CyberArk Authentication fails when using hardware tokens 18Number of Views
Trending Articles
RSA MFA Agent 2.3.6 for Microsoft Windows Installation and Administration Guide RSA Authentication Manager 8.9 Release Notes (January 2026) RSA Release Notes: Cloud Access Service and RSA Authenticators RSA Release Notes for RSA Authentication Manager 8.8 RSA-2026-04: RSA Governance and Lifecycle Security Update for SUSE Linux Enterprise Server Vulnerabilities