mng.GetUserRoles

This job lists the system roles for the logged-in user or a specified user.

Without specifying a user, the system roles of the logged-in user are listed.

1. Input Parameters

Name Type Required Description

Flags

INT

Yes

Currently not supported → pass 0

UserGUID

STRING

Yes

GUID of the user. Empty or GUID of the logged-in user: no system role required. GUID of another user: system role 4 required.

[UserId]

STRING

No

ID of the user; currently has no effect and is ignored by the server

2. Output Parameters

Name Type Dependency Description

Result

String

—

List of system role IDs, separated by semicolon. See System Roles.

3. Return Value

(INT): 0 = Job successful, otherwise error code

4. Required System Role

The system role is only checked when querying other users:

  • UserGUID omitted, empty or equal to the GUID of the logged-in user — no system role is required; every user may query their own system roles.

  • UserGUID of another user — the calling user requires system role 4 (Administrator: Configure security system — configure the rights system). If this role is missing, the call is rejected with the error code -1040906164; see Error Codes.

An overview of all roles is available under System Roles.