You can use the RSA SecurID Access Delete User Device API to delete a user's device for the provided User ID and Device ID.
Note: Only one user device can be deleted per request.
Clients calling this API must authenticate themselves by including a JSON Web Token in a request. For instructions on using this token, see Authentication for the Cloud Administration REST APIs .
Software Developer Kit
You can download the API Software Developer Kit (SDK) from RSA SecurID Access Administration REST API Download.
Use the following information to delete a particular user's device.
|Method||Request URL||Response Codes|
|DELETE||/AdminInterface/restapi/v1/users/<userId>/devices/<deviceId>||200, 400, 403, 404, 500|
Example Request Data
The following example displays a request to delete a device.
Authorization: Bearer <JWT token>
The delete device request does not contain any parameters.
The following table shows the resource identifiers for a user and a device that are required in the request URL.
|<userId>||A unique user identifier that is sent in the response to the RSA SecurID Access User Details API .|
|<deviceId>||A unique device identifier that is sent in the response to the RSA SecurID Access Device Details API .|
Note: Response examples and property response descriptions are not available for this API.
The following table shows response codes and descriptions for this API.
|200||User and device are successfully found.|
|400||User ID is not provided as parameter.|
|403||Not authorized to perform the request.|
|404||User and/or device is not found.|
|500||Internal error occurred when processing the request.|