Update an Authentication Type
put
/api/AAA/AuthTypes/{id}
Updates the properties of the authentication type that matches the specified ID.
Request
Path Parameters
-
id(required): integer(int32)
The authentication type ID.Example:
1
Supported Media Types
- application/json
Root Schema : schema
Type:
objectThe details of an authentication type to update.
Show Source
-
AuthenticationStatus: boolean
Whether the authentication type is enabled (1) or not (0).Example:
1 -
AuthenticationTypeName: string
The authentication type name.Example:
Internal -
PasswordMinimumLength: integer
The minimum password length. This is used for internal authorization only.Example:
4 -
PasswordRequiredLowercase: integer
The minimum number of lowercase letters required in the password. This is used for internal authorization only.Example:
1 -
PasswordRequiredNumbers: integer
The minimum number of numerals required in the password. This is used for internal authorization only.Example:
0 -
PasswordRequiredSpecialCharacters: integer
The minimum number of special characters required in the password. This is used for internal authorization only.Example:
0 -
PasswordRequiredUppercase: integer
The minimum number of uppercase letters required in the password. This is used for internal authorization only.Example:
0 -
PasswordResetAvailable: integer
The number of password resets available. This is used only for internal authorization.Example:
0 -
PasswordResetCustomText: string
The question to ask a user when they reset their password. This is used for internal authentication only.Example:
-
PasswordResetQuestion1: string
The question to ask a user when they reset their password. This is used for internal authentication only.Example:
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulUpdateOperation
The response body for a successful update operation.
-
object
type
Nested Schema : SuccessfulUpdateOperation
Type:
objectThe response body for a successful update operation.
Show Source
-
message: string
The response message.Example:
Updated record -
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : type
Type:
Show Source
object-
data: array
data
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : data
Type:
Show Source
array-
Array of:
object AAAAuthTypesRead
Authentication type details.
Nested Schema : AAAAuthTypesRead
Type:
objectAuthentication type details.
Show Source
-
AuthenticationStatus: boolean
Whether the authentication is enabled (1) or not (0).Example:
1 -
AuthenticationStatusIcon: string
The authentication status icon.Example:
OrbGreen.png -
AuthenticationTypeID: integer
The authentication type ID.Example:
1 -
AuthenticationTypeName: string
The authentication type name.Example:
Internal -
PasswordMinimumLength: integer
The minimum password length. This is used for internal authorization only.Example:
4 -
PasswordRequiredLowercase: integer
The minimum number of lowercase letters required in the password. This is used for internal authorization only.Example:
1 -
PasswordRequiredNumbers: integer
The minimum number of numerals required in the password. This is used for internal authorization only.Example:
0 -
PasswordRequiredSpecialCharacters: integer
The minimum number of special characters required in the password. This is used for internal authorization only.Example:
0 -
PasswordRequiredUppercase: integer
The minimum number of uppercase letters required in the password. This is used for internal authorization only.Example:
0 -
PasswordResetAvailable: integer
The number of password resets available. This is used for internal authorization only.Example:
0 -
PasswordResetCustomText: string
Custom text to show when resetting a password. This is used for internal authentication only.Example:
-
PasswordResetQuestion1: string
The question to ask a user when they reset their password. This is used for internal authentication only.Example:
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown -
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
arrayThe list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
objectAn error.