Skip to main content

KBAApi

MethodHTTP requestDescription
AddKnowledgeBasedAuthenticatorUsingPOSTPOST /api/web/v1/users/{userid}/userquestionsAdd a knowledge-based authenticator
DeleteUserKbaChallengesUsingDELETEDELETE /api/web/v1/users/{userid}/kbachallengesDelete retained knowledge-based authenticator challenges
DeleteUserKbaQuestionUsingDELETEDELETE /api/web/v1/users/{userid}/userquestions/{id}Delete a question from the knowledge-based authenticator
DeleteUserKbaUsingDELETEDELETE /api/web/v1/users/{userid}/userquestionsDelete the knowledge-based authenticator
GetKbaQuestionsUsingGETGET /api/web/v1/users/userquestions/{locale}Get a list of Knowledge-based questions that a user can answer
GetUserKbaUsingGETGET /api/web/v1/users/{userid}/userquestionsGet the knowledge-based authenticator
UpdateKnowledgeBasedAuthenticatorUsingPUTPUT /api/web/v1/users/{userid}/userquestionsModify a knowledge-based authenticator

AddKnowledgeBasedAuthenticatorUsingPOST

void AddKnowledgeBasedAuthenticatorUsingPOST (string userid, KnowledgeBasedAuthenticator knowledgeBasedAuthenticator)

Add a knowledge-based authenticator

Add a knowledge-based authenticator for the specified user. Caller requires the USERQUESTIONANSWERS:ADD permission.

Using the AddKnowledgeBasedAuthenticatorUsingPOSTWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstring
knowledgeBasedAuthenticatorKnowledgeBasedAuthenticator

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

DeleteUserKbaChallengesUsingDELETE

void DeleteUserKbaChallengesUsingDELETE (string userid)

Delete retained knowledge-based authenticator challenges

Delete all retained knowledge-based authenticator challenges for the specified user. Caller requires the USERQUESTIONS:REMOVE permission.

Example

Using the DeleteUserKbaChallengesUsingDELETEWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user from which the retained KBA challenges are to be deleted.

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

DeleteUserKbaQuestionUsingDELETE

void DeleteUserKbaQuestionUsingDELETE (string userid, string id)

Delete a question from the knowledge-based authenticator

Delete a specified question from the knowledge-based authenticator of the specified user. Caller requires the USERQUESTIONS:REMOVE permission.

Example

Using the DeleteUserKbaQuestionUsingDELETEWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user from which a specific KBA question is to be deleted.
idstringThe UUID of the question to be deleted.

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

DeleteUserKbaUsingDELETE

void DeleteUserKbaUsingDELETE (string userid)

Delete the knowledge-based authenticator

Delete the knowledge-based authenticator for the specified user. Caller requires the USERQUESTIONS:REMOVE permission.

Example

Using the DeleteUserKbaUsingDELETEWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user whose KBA infomration is to be removed.

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

GetKbaQuestionsUsingGET

List<UserQuestion> GetKbaQuestionsUsingGET (string locale)

Get a list of Knowledge-based questions that a user can answer

Get a list of Knowledge-based questions for the specified locale (language). The locale should be the two letter Caller requires the USERQUESTIONS:VIEW permission.

Example

Using the GetKbaQuestionsUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
localestring

Return type

List<UserQuestion>

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

GetUserKbaUsingGET

KnowledgeBasedAuthenticator GetUserKbaUsingGET (string userid)

Get the knowledge-based authenticator

Get the knowledge-based authenticator for the specified user. Caller requires the USERQUESTIONS:VIEW permission.

Example

Using the GetUserKbaUsingGETWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstringThe UUID of the user whose KBA information is to be retrieved.

Return type

KnowledgeBasedAuthenticator

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-

UpdateKnowledgeBasedAuthenticatorUsingPUT

void UpdateKnowledgeBasedAuthenticatorUsingPUT (string userid, KnowledgeBasedAuthenticator knowledgeBasedAuthenticator)

Modify a knowledge-based authenticator

Modify a knowledge-based authenticator for the specified user. Caller requires the USERQUESTIONANSWERS:EDIT permission.

Example

Using the UpdateKnowledgeBasedAuthenticatorUsingPUTWithHttpInfo variant

This returns an ApiResponse object which contains the response data, status code and headers.

Parameters

NameTypeDescriptionNotes
useridstring
knowledgeBasedAuthenticatorKnowledgeBasedAuthenticator

Return type

void (empty response body)

Authorization

AdminAPIAuthentication

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Successful-
400Bad Request-
401Access denied-
403Forbidden-
404Not Found-
409Conflict-