Skip to main content

AuthenticationApi

MethodHTTP requestDescription
logoutUsingPOSTPOST /api/web/v1/authentication/logoutRemove User Session
requestPasskeyChallengeUsingPOSTPOST /api/web/v1/authentication/passkeyRequest Passkey Challenge
userAuthenticateUsingPOSTPOST /api/web/v1/authentication/users/authenticate/{authenticator}/completeAuthenticate User Challenge
userAuthenticatorQueryUsingPOSTPOST /api/web/v2/authentication/usersQuery User Authenticators
userChallengeUsingPOSTPOST /api/web/v2/authentication/users/authenticate/{authenticator}Request User Challenge

logoutUsingPOST

logoutUsingPOST(authorization)

Remove User Session

Parameters

NameTypeDescriptionNotes
authorizationString[optional]

Return type

null (empty response body)

Authorization

No authorization required

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-

requestPasskeyChallengeUsingPOST

PasskeyChallengeResult requestPasskeyChallengeUsingPOST(passkeyChallengeParameters)

Request Passkey Challenge

Request passkey challenge. This API is deprecated, use /api/web/v2/authentication/users/authenticate/PASSKEY instead.

Example

Parameters

NameTypeDescriptionNotes
passkeyChallengeParametersPasskeyChallengeParameters

Return type

PasskeyChallengeResult

Authorization

No authorization required

HTTP request headers

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

HTTP response details

Status codeDescriptionResponse headers
200Authenticators retrieved successfully-
400Bad request-
401Access denied-
403Forbidden-
404Not Found-

userAuthenticateUsingPOST

AuthenticatedResponse userAuthenticateUsingPOST(authenticator, userAuthenticateParameters, authorization)

Authenticate User Challenge

Example

Parameters

NameTypeDescriptionNotes
authenticatorString[enum: MACHINE, PASSWORD, EXTERNAL, KBA, TEMP_ACCESS_CODE, OTP, GRID, TOKEN, TOKENPUSH, FIDO, SMARTCREDENTIALPUSH, PASSWORD_AND_SECONDFACTOR, SMART_LOGIN, IDP, PASSKEY, IDP_AND_SECONDFACTOR, USER_CERTIFICATE, FACE]
userAuthenticateParametersUserAuthenticateParameters
authorizationString[optional]

Return type

AuthenticatedResponse

Authorization

No authorization required

HTTP request headers

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

HTTP response details

Status codeDescriptionResponse headers
200Authenticators retrieved successfully-
400Bad request-
401Access denied-
403Forbidden-
404Not Found-

userAuthenticatorQueryUsingPOST

UserAuthenticateQueryResponse userAuthenticatorQueryUsingPOST(userAuthenticateQueryParameters)

Query User Authenticators

Example

Parameters

NameTypeDescriptionNotes
userAuthenticateQueryParametersUserAuthenticateQueryParameters

Return type

UserAuthenticateQueryResponse

Authorization

No authorization required

HTTP request headers

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

HTTP response details

Status codeDescriptionResponse headers
200Authenticators retrieved successfully-
400Bad request-
401Access denied-
403Forbidden-
404Not Found-

userChallengeUsingPOST

AuthenticatedResponse userChallengeUsingPOST(authenticator, userChallengeParameters)

Request User Challenge

Example

Parameters

NameTypeDescriptionNotes
authenticatorString[enum: MACHINE, PASSWORD, EXTERNAL, KBA, TEMP_ACCESS_CODE, OTP, GRID, TOKEN, TOKENPUSH, FIDO, SMARTCREDENTIALPUSH, PASSWORD_AND_SECONDFACTOR, SMART_LOGIN, IDP, PASSKEY, IDP_AND_SECONDFACTOR, USER_CERTIFICATE, FACE]
userChallengeParametersUserChallengeParameters

Return type

AuthenticatedResponse

Authorization

No authorization required

HTTP request headers

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

HTTP response details

Status codeDescriptionResponse headers
200Authenticators retrieved successfully-
400Bad request-
401Access denied-
403Forbidden-
404Not Found-