OBJECT

User

A user represents a user account within an organization.

link GraphQL Schema definition

1type User {
2
3# The user's name
4name: String!
5
6# The user's unique ID.
7# A user ID is a string in UUID format.
8id: ID!
9
10# The set of permissions granted to the user
11permissions: PermissionList
12
13# The set of roles granted to the user
14roles: [Role!]
15
16roleIds: [ID!]
17
18# ID of the organization to which the user belongs.
19organizationId: ID
20
21# GUID of the organization to which the user belongs.
22organizationGuid: ID
23
24# Organization to which the user belongs.
25organization: Organization
26
27# GUID of organizations to which the user belongs.
28organizationGuids: [ID]
29
30# Freeform metadata in JSON form
31jsondata: JSONData
32
33firstName: String
34
35lastName: String
36
37email: String
38
39acls: [UserACL!]
40
41title: String
42
43developerType: String
44
45# Folder tree for this organization
46#
47# Arguments
48# type: Specify a root folder type to retrieve a specific root
49# folder
50rootFolder(type: RootFolderType): Folder
51
52# Date and time this user last changed their password
53passwordUpdatedDateTime: DateTime
54
55# Date and time this user last logged in
56lastLoginDateTime: DateTime
57
58# Date and time this user account was created
59createdDateTime: DateTime
60
61# Date and time this user account was last modified
62modifiedDateTime: DateTime
63
64# Multi-factor authentication information for the user
65mfaInfo: MFAInfo!
66
67# User Settings for the user
68userSettings: [UserSetting!]
69
70imageUrl: String
71
72# Status of user account
73status: UserStatus
74
75# Notifications from user default mailbox
76notifications(
77dateTimeFilter: [NotificationDateTimeFilter!],
78offset: Int,
79limit: Int,
80orderBy: NotificationDateTimeField,
81orderDirection: OrderDirection,
82flags: [NotificationFlag!],
83flagsMode: filterCombineOperator
84): NotificationList
85
86# The flag indicate that the user is "virtual" system user
87systemUser: Boolean
88
89# The application keys that allowed to run as system user.
90appsAllowedToRunAsUser: [String]
91
92# Multi Organization Invite
93organizationInvites(
94organizationInviteId: ID,
95status: OrganizationInviteStatus,
96inviteType: OrganizationInviteType
97): [OrganizationInvite]
98
99# SCIM represents linked user information from a third party identity provider.
100scim(connectors: [ID]): SCIMUserList
101
102# Notification mailboxes owned by this user.
103#
104# The result is always constrained to this user. What a caller can see depends
105# on its credential:
106# - a user session token sees only its own mailboxes; on any other user's node
107#
108# this field returns an empty result (that is not an error);
109# - an organization API key sees mailboxes of users in its own organization;
110# - superadmin and internal tokens are unrestricted.
111# `name` is an exact match. The result is not paged. Under a list parent
112# (`users`, `organization.users`) the lookup is batched across users
113# regardless of the arguments supplied.
114# Example:
115# Request:
116# query {
117#
118# user(id: "267de7e1-efb2-444a-a524-210328b78503") {
119#
120# notificationMailboxes(name: "dmhWorkflowNotifications") {
121#
122# records {
123#
124# id
125#
126# name
127#
128# paused
129#
130# }
131#
132# count
133#
134# }
135#
136# }
137# }
138# Response:
139# {
140#
141# "data": {
142#
143# "user": {
144#
145# "notificationMailboxes": {
146#
147# "records": [
148#
149# {
150#
151# "id": "6fda80b5-3d1a-4eb8-bd32-277be5104149",
152#
153# "name": "dmhWorkflowNotifications",
154#
155# "paused": false
156#
157# }
158#
159# ],
160#
161# "count": 1
162#
163# }
164#
165# }
166#
167# }
168# }
169#
170# Arguments
171# ids: Restrict the result to these mailbox IDs (each must be a
172# UUID). An empty
173# list applies no filter.
174# name: Restrict the result to mailboxes with exactly this name.
175notificationMailboxes(ids: [ID!], name: String): NotificationMailboxList
176
177}