Skip to main content

PasswordsApi

MethodHTTP requestDescription
delete_user_password_using_deleteDELETE /api/web/v1/users/{userid}/passwordsDelete a user password
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
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_password_using_delete

delete_user_password_using_delete(userid)

Delete a user password

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.

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_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-

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-