Skip to main content

PasswordsApi

MethodHTTP requestDescription
delete_user_named_password_using_deleteDELETE /api/web/v1/users/{userid}/passwords/{namedpasswordid}Delete a user password using the password ID
delete_user_password_using_deleteDELETE /api/web/v1/users/{userid}/passwordsDelete a user password
get_user_named_password_settings_using_getGET /api/web/v1/users/{userid}/settings/password/{namedpasswordid}Get user password authenticator settings by named password ID
get_user_named_passwords_using_getGET /api/web/v1/users/{userid}/list/passwordsGets a list of user passwords
get_user_password_settings_using_getGET /api/web/v1/users/{userid}/settings/passwordGets a user password settings
get_user_password_using_getGET /api/web/v1/users/{userid}/passwordsGets a user password
send_password_expiry_notification_using_putPUT /api/web/v1/users/{userid}/password/notifyUpdate and send a password expiry notification
send_user_named_password_expiry_notification_using_putPUT /api/web/v1/users/{userid}/password/{namedpasswordid}/notifyUpdate and send a password expiry notification using password ID
set_user_password_using_putPUT /api/web/v1/users/{userid}/passwordsSet a user password
validate_user_password_using_postPOST /api/web/v1/users/{userid}/password/validateValidate user password

delete_user_named_password_using_delete

delete_user_named_password_using_delete(userid, namedpasswordid)

Delete a user password using the password ID

Delete the user's password. Caller requires the USERPASSWORDS:REMOVE permission.

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user from which the password will be deleted.
namedpasswordidstr

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-

delete_user_password_using_delete

delete_user_password_using_delete(userid)

Delete a user password

Delete the user's password. Caller requires the USERPASSWORDS:REMOVE permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user from which the password will 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-

get_user_named_password_settings_using_get

UserPasswordSettings get_user_named_password_settings_using_get(userid, namedpasswordid)

Get user password authenticator settings by named password ID

Get password settings information for the specified user. Caller requires the USERPASSWORDS:VIEW permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user whose password settings information is to be fetched.
namedpasswordidstrThe named password ID whose password settings information is to be fetched.

Return type

UserPasswordSettings

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-

get_user_named_passwords_using_get

List[UserPassword] get_user_named_passwords_using_get(userid)

Gets a list of user passwords

Get password information for the specified user. Caller requires the USERPASSWORDS:VIEW permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user whose password information is to be fetched.

Return type

List[UserPassword]

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-

get_user_password_settings_using_get

UserPasswordSettings get_user_password_settings_using_get(userid)

Gets a user password settings

Get password settings information for the specified user. Caller requires the USERPASSWORDS:VIEW permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user whose password settings information is to be fetched.

Return type

UserPasswordSettings

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-

get_user_password_using_get

UserPassword get_user_password_using_get(userid)

Gets a user password

Get password information for the specified user. Caller requires the USERPASSWORDS:VIEW permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user whose password information is to be fetched.

Return type

UserPassword

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-

send_password_expiry_notification_using_put

send_password_expiry_notification_using_put(userid)

Update and send a password expiry notification

Updates and sends a password expiry notification to the specified user. Caller requires the USERPASSWORDS:EDIT permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user to send an expiry notification to.

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-

send_user_named_password_expiry_notification_using_put

send_user_named_password_expiry_notification_using_put(userid, namedpasswordid)

Update and send a password expiry notification using password ID

Updates and sends a password expiry notification to the specified user. Caller requires the USERPASSWORDS:EDIT permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user to send an expiry notification to.
namedpasswordidstr

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-

set_user_password_using_put

UserPassword set_user_password_using_put(userid, user_password_parms)

Set a user password

Set a user password for the specified user. Caller requires the USERPASSWORDS:EDIT permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user whose password is to be created or modified.
user_password_parmsUserPasswordParms

Return type

UserPassword

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-

validate_user_password_using_post

UserPasswordValidationResponse validate_user_password_using_post(userid, user_password_validation_parms)

Validate user password

Validate user password. Caller requires the USERPASSWORDS:EDIT permission.

Example

  • Api Key Authentication (AdminAPIAuthentication):

Parameters

NameTypeDescriptionNotes
useridstrThe UUID of the user whose password is to be validated.
user_password_validation_parmsUserPasswordValidationParms

Return type

UserPasswordValidationResponse

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-