Cloud Administration Delete SecurID DS100 OTP Credential API
a year ago

Cloud Administration Delete SecurID DS100 OTP Credential API

The Cloud Administration Delete SecurID DS100 OTP credential API allows Help Desk Administrators and Super Administrators to delete OTP credential of SecurID DS100 authenticator. After the credential is successfully deleted, the user cannot authenticate with the credential.

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 a 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 an OTP credential by providing credential and device serial number.

MethodRequest URLResponse Content TypeResponse BodyResponse Codes
DELETE/AdminInterface/restapi/v1/ds100/delete/otpapplication/json Not Applicable200, 400, 403, 404, 429, 500

Example Request Data

The following example displays a request.

DELETE /AdminInterface/restapi/v1/ds100/delete/otp

Accept: application/json

Authorization: Bearer <JWT token>

Example Request Body

{

"tokenSerialNumber": "014010008038",

"deviceSerialNumber": "140100080",

"userId" : "87927fb7-e185-4c33-c7e3-8e077675973c"

}

Request Property Descriptions

PropertyDescriptionData Type
tokenSerialNumberThe serial number of the OTP credential. The credential serial number can be obtained using Retrieve SecurID DS100 OTP credential API.String
deviceSerialNumberThe serial number of the hardware authenticator. The number is displayed at the back of the SecurID DS100 authenticator.String
userId Identifies the user associated with this authenticator.String

Response Codes

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

CodeDescription
200Successfully deleted OTP credential for SecurID DS100 authenticator assigned to the user.
400Bad Request. Operation not performed because of client syntax errors.
403Not authorized to perform the request.
404Either the user or the SecurID DS100 authenticator does not exist.
429Too many requests.
500Internal server error occurred while processing the request.