Update a User
put
/api/AAA/Users/{id}
Updates the properties of the user that matches the specified ID.
Request
Path Parameters
-
id(required): integer(int32)
The user ID.Example:
1
Supported Media Types
- application/json
Root Schema : schema
Type:
object
Details of the user to create or update.
Show Source
-
AccountExpiration: string
The date when the account's password will expire. Set to 0 for never, or a date/time string in a format parsable by the strtotimeM PHP function.Example:
[Never]
-
AccountStatus: string
A flag to indicate if the user account is enabled or disabled. Possible values are 0 for disabled or 1 for enabled.Example:
1
-
AuthenticationType: integer
Unique identifier for the authentication type instance.Example:
1
-
EmailAddress: string
The user email address.Example:
example@example.com
-
FullName: string
The full name of the user.Example:
Operator
-
Password: string
The user's password. Required for Internal authentication only.Example:
-
PasswordChange: string
When the user's password will expire. Set either this or PasswordExpiration, not both.
Allowed values are:- never: The password never expires.
- immediate: The password expires the next time the user logs in, and they must reset it immediately.
- YYYY-MM-DD: The date when the password expires.
Example:date
-
PasswordExpiration: string
The UNIX timestamp when the user's password will expire. Set either this or PasswordChange, not both. 0 means immediate, 2147483647 means never.Example:
2147483647
-
Preferences: array
Preferences
The user preferences.
-
Properties: array
Properties
The user's properties.
-
RepeatPassword: string
The user's password, repeated. Required for Internal authentication only.Example:
-
Subgroups: array
Subgroups
A list of the user's subgroup IDs. Users inherit only restrictive access properties set for the subgroup, not roles or preferences. The same group cannot appear in both the UserGroup (primary) and Subgroups list for the user.
-
SupportPassword: string
The Unified Assurance support site password.Example:
-
SupportUsername: string
The support user name.Example:
-
UserGroup: integer
The unique identifier for the primary user group from which the user inherits configurations, including roles, properties, and preferences.Example:
1
-
UserName: string
The username.
To avoid confusion with numeric IDs, the name value cannot be integers only or integers prefixed with the + or - symbols only. It must contain letters or other characters. For example, 1234, +1234, and -1234 are not valid, but US1234, US+1234 and US_1234 are.Example:operator
Nested Schema : Subgroups
Type:
array
A list of the user's subgroup IDs. Users inherit only restrictive access properties set for the subgroup, not roles or preferences. The same group cannot appear in both the UserGroup (primary) and Subgroups list for the user.
Example:
[2, 1001]
Nested Schema : items
Type:
Show Source
object
-
Description: string
The preference description.Example:
Default event list display (default 'Default')
-
id: integer
Example:
1
-
Override: integer
Whether the preference is unlocked (0), allowing the user to override their group preference, or locked (1), preventing the user from overriding it.Example:
0
-
PreferenceID: integer
The preference ID.Example:
3
-
PreferenceName: string
The preference name.Example:
DefaultDisplayID
-
PreferenceValue: integer
The preference value.Example:
5
Nested Schema : items
Type:
Show Source
object
-
Description: string
The description of the property.Example:
Reserved for future use
-
id: integer
Example:
2
-
PropertyID: integer
The property ID.Example:
1
-
PropertyName: string
The property name.
To avoid confusion with numeric IDs, the name value cannot be integers only or integers prefixed with the + or - symbols only. It must contain letters or other characters. For example, 1234, +1234, and -1234 are not valid, but US1234, US+1234 and US_1234 are.Example:ResetQuestion
-
PropertyValue: string
The property value.Example:
resetval
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:
object
The 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 : AAAUsersRead
Type:
object
User details.
Show Source
-
AccountExpiration: string
The date when the account's password will expire. 0 means it never expires.Example:
[Never]
-
AccountStatus: integer
A flag to indicate if the user account is enabled (1) or disabled (0).Example:
1
-
AuthenticationType: object
AuthenticationType
The authentication type instance for the user..
-
AuthenticationTypeName: string
The authentication type instance name.Example:
Internal
-
EmailAddress: string
The user email address.Example:
example@example.com
-
FailedLoginCount: integer
The number of failed logins.Example:
0
-
FullName: string
The full name of the user.Example:
Operator
-
LastLoginFailed: integer
The last failed login attempt.Example:
0
-
LastLoginSuccess: integer
The last successful login attempt.Example:
0
-
Password: string
The user's password. Required for Internal authentication only.Example:
-
PasswordExpiration: string
The UNIX timestamp when the password will expire. 0 means it has expired.Example:
2147483647
-
Preferences: array
Preferences
The user preferences.
-
Properties: array
Properties
The user's properties.
-
RepeatPassword: string
The user's password, repeated. Required for Internal authentication only.Example:
-
Subgroups: array
Subgroups
A list of the user's subgroup IDs. Users inherit only restrictive access properties set for the subgroup, not roles or preferences.
-
SupportUsername: string
The support user name.Example:
-
UserGroup: object
UserGroup
The user group.
-
UserGroupName: string
The user group name.Example:
Administrators
-
UserID: integer
The user ID.Example:
1065
-
UserName: string
The user name.Example:
operator
Nested Schema : AuthenticationType
Type:
object
The authentication type instance for the user..
Show Source
-
id: integer
The unique identifier for the authentication type instance.
-
name: string
The name for the authentication type instance.
Example:
{
"id":"1",
"name":"Internal"
}
Nested Schema : Subgroups
Type:
array
A list of the user's subgroup IDs. Users inherit only restrictive access properties set for the subgroup, not roles or preferences.
Example:
[2, 1001]
Nested Schema : UserGroup
Type:
object
The user group.
Show Source
-
id: integer
The unique identifier for the primary user group from which the user inherits configurations which includes roles, properties, and preferences.
-
name: string
The user group name.
Example:
{
"id":"1",
"name":"Administrators"
}
Nested Schema : items
Type:
Show Source
object
-
Description: string
The preference description.Example:
Default event list display (default 'Default')
-
Override: integer
Whether the preference is unlocked (0), allowing the user to override their group preference, or locked (1), preventing the user from overriding it.Example:
0
-
PreferenceID: integer
The preference ID.Example:
3
-
PreferenceName: string
The preference name.Example:
DefaultDisplayID
-
PreferenceValue: string
The preference value.Example:
5
Nested Schema : items
Type:
Show Source
object
-
Description: string
The description associated with the property.Example:
Reserved for future use
-
PropertyID: integer
The property ID.Example:
1
-
PropertyName: string
The property name.Example:
ResetQuestion
-
PropertyValue: string
The property value.Example:
resetval
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:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.