The per-user operating system configuration of one user account on an Endpoint, complementing the machine-wide SystemSettings. Collected on macOS only, it carries UserSystemSettingsMacOS, read from the user's own preference domains and account record: screen saver idle time and whether a password is required after sleep or screen saver, Universal Control, Siri and search data sharing, Bluetooth sharing, the user's location daemon preference and whether a password hint is set. One UserSystemSettings exists per (endpoint, user) pair; it is linked to its EndpointUser and is reachable from that user's userSystemSettings field rather than directly from the Endpoint.
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The UserSystemSettings' unique identifier on the security graph. |
orgId - OrganizationId!
|
Unique identifier that corresponds to your deployment of this product or a specific customer account that this Endpoint belongs to. |
objectType - GraphObjectType!
|
The type of this graph object. |
objectTypeLabel - String!
|
A localized label describing the object type. |
displayName - String!
|
A concise human-friendly identifier for this object suitable for display in user interface page titles and in AI chat responses that refer to the object. |
firstSeen - Time!
|
Time this object was first seen. |
lastSeen - Time!
|
Time this object was last seen. |
seen - SeenOnline!
|
Describes when this UserSystemSettings was seen. |
createdAt - Time!
|
The time this object was created in the security graph. |
updatedAt - Time!
|
The time this object was last mutated in the security graph. |
snapshotInfo - GraphObjectSnapshotInfo!
|
Whether this object is a point-in-time snapshot of an object's state rather than the object's live state, and when that state was observed. |
endpointUser - EndpointUser
|
The EndpointUser these settings apply to. |
osSpecific - UserSystemSettingsOsSpecific
|
The platform-specific per-user settings. Currently always UserSystemSettingsMacOS. |
findings - FindingsPayload!
|
Policy findings for this object. |
issues - IssuesPayload!
|
Policy issues for this object. |
issuesSummary - IssuesSummary!
|
Summary of the active policy issues currently open on this object, broken down by severity. |
Returned by
userSystemSettingsquery: Retrieves one macOS user's UserSystemSettings by its graph object id: screen saver locking, Universal Control, Siri and search data sharing,…
Used by
EndpointUsertype: An operating system or domain user account observed on an Endpoint.GraphObjectTypeenum: An enumeration of the different types of security graph objects.GraphObjectTypeCategoryenum: High-level grouping used to organize GraphObjectType values in UI navigation and API discovery.UserSystemSettingsPayloadtype: Payload wrapper for a single UserSystemSettings result.
Related types
EndpointUserAn operating system or domain user account observed on an Endpoint.
Example
Example
{
"id": 4,
"orgId": "615f3b3b28284380e28a7342",
"objectType": "ACCOUNT_POLICY",
"objectTypeLabel": "abc123",
"displayName": "abc123",
"firstSeen": "2021-10-07T18:23:25.829Z",
"lastSeen": "2021-10-07T18:23:25.829Z",
"seen": SeenOnline,
"createdAt": "2021-10-07T18:23:25.829Z",
"updatedAt": "2021-10-07T18:23:25.829Z",
"snapshotInfo": GraphObjectSnapshotInfo,
"endpointUser": EndpointUser,
"osSpecific": UserSystemSettingsMacOS,
"findings": FindingsPayload,
"issues": IssuesPayload,
"issuesSummary": IssuesSummary
}