Service: User

Reading and editing users

Provides read/write access to the user Data Objects.

Functions

ResultName / ParamsComment
GetResultuser.GetReturns a filtered list of User Objects. Only for the UI the users will contain the password property though.
filterstring(Optional) Filter expression which determines the result set.
selectstring[](Optional) List of properties that should be contained in the result objects.
limitint(Optional) Maximum amount of Objects that should be returned. (Max : 100000)
GetResultuser.GetReturns a filtered list of User Objects as a follow up to a previous Get call. Only for the UI the users will contain the password property though.
contextstringThe context received within the last get result. Mandatory for subsequent get calls with pagination.
scrollintScrolls through the result set with 'Next' or 'Prev'. Used for pagination. See EnumPaginationScroll.
offsetint(Optional) Offset of the first Object in the result set that should be returned. Used for direct pagination.
limitint(Optional) Maximum amount of Objects that should be returned. (Max : 100000)
Useruser.GetOneReturns a single User Object identified by the given id. Only for the UI it will contain the password property though.
idguidThe User's id.
selectstring[](Optional) List of properties that should be contained in the result object.
guiduser.CreateCreates the User in the system and returns the id of the User. When the User does not have an id a new one is created. If a User with the same id already exists the new one is not saved and an empty id is returned. Currently only accessible by the UI.
objectUserThe User to create.
booluser.UpdateUpdates a User with data from the provided Object. Currently only accessible by the UI.
objectUserUser to update
booluser.SetSets specific properties of a User Object. Currently only accessible by the UI.
idguidId of the User to modify.
propsvalue{}List of properties that should be set. Property paths may be used as ids to address any partial aspect of the Object.
booluser.DeleteDeletes a User Object. Returns true if successfully deleted or if no such Object existed to begin with. Currently only accessible by the UI.
idguidId of the User to delete.
booluser.BulkModifyPerforms a bulk of changes at once. Currently only accessible by the UI.
createUser[](Optional) List of User Objects to create.
updateUser[](Optional) List of User Objects to update.
setObjectAspect[](Optional) List of User Object properties to set.
deleteguid[](Optional) List of User ids to delete.

Notifications

Name / ParamsComment
user.CreatedNotifies new User Objects.
objectsUser[]Newly created User Objects. Only for the UI the users will contain the password property though.
user.UpdatedNotifies updated User Objects.
objectsUser[]Changed User Objects. Only for the UI the users will contain the password property though.
user.DeletedNotifies deleted User Objects.
idsguid[]Ids of the deleted User Objects.

Objects

User

Property Type Description
Id guid (Unique, Readonly) The unique id of the user.
ParentId guid
Type int See EnumUserType.
Code string (Unique) Short (max 8 characters) user string id
Login <wg 0.6.0 string (Unique) Login name (max 120 characters) of the user.
Domain <wg 0.6.0 string Used with LDAP users (max 50 characters).
Password <wg 0.6.0 string (Not in default set) User password (max 50 characters). Can only be accessed by the UI.
SourceLinks ≥wg 0.6.0 SourceLink[] Sources associated with this user.
ProfileIds guid[] Assigned profiles.
Flags int See EnumUserFlags.
Info string Remarks
PersonId guid
FirstName string (max 200 characters)
LastName string (max 50 characters)
ExtRef string
LastLoginTime time (Readonly)
LastLoginStation int (Readonly)
EditTime time (Readonly, Not in default set)
EditUser string (Readonly, Not in default set)
Property Type Description
Login string Login name of the user.
Source string Code of the Authentication Extension that handles this user login.

Enums

EnumUserType

Name Value Description
User 1
Group 2

EnumUserFlags (Flags)

Name Value Description
IsDisabled 0x1 User account is disabled.
IsInfo <wg 0.6.0 0x2 This is just an info entry for an externally authenticated user.
IsAdmin 0x4 This is an admin without rights limitations. The last admin cannot be deleted.
Last modified September 25, 2026