---
title: UserSystemSettings type | Wartiva GraphQL API
description: The per-user operating system configuration of one user account on an Endpoint, complementing the machine-wide SystemSettings.
url: https://wartiva.com/api-docs/types/user-system-settings.html
updated: 2026-10-07
---

Endpoint configuration · GraphQL type

# `UserSystemSettings` type

The per-user operating system configuration of one user account on an [Endpoint](https://wartiva.com/api-docs/types/endpoint.html), complementing the machine-wide [SystemSettings](https://wartiva.com/api-docs/types/system-settings.html). Collected on macOS only, it carries [UserSystemSettingsMacOS](https://wartiva.com/api-docs/types/user-system-settings-mac-os.html), 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](https://wartiva.com/api-docs/types/endpoint-user.html) and is reachable from that user's `userSystemSettings` field rather than directly from the Endpoint.

## Fields

| Field Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The UserSystemSettings' unique identifier on the security graph. |
| `orgId` - [`OrganizationId!`](https://wartiva.com/api-docs/types/organization-id.html) | Unique identifier that corresponds to your deployment of this product or a specific customer account that this Endpoint belongs to. |
| `objectType` - [`GraphObjectType!`](https://wartiva.com/api-docs/types/graph-object-type.html) | The type of this graph object. |
| `objectTypeLabel` - [`String!`](https://wartiva.com/api-docs/types/string.html) | A localized label describing the object type. |
| `displayName` - [`String!`](https://wartiva.com/api-docs/types/string.html) | 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!`](https://wartiva.com/api-docs/types/time.html) | Time this object was first seen. |
| `lastSeen` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | Time this object was last seen. |
| `seen` - [`SeenOnline!`](https://wartiva.com/api-docs/types/seen-online.html) | Describes when this UserSystemSettings was seen. |
| `createdAt` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The time this object was created in the security graph. |
| `updatedAt` - [`Time!`](https://wartiva.com/api-docs/types/time.html) | The time this object was last mutated in the security graph. |
| `snapshotInfo` - [`GraphObjectSnapshotInfo!`](https://wartiva.com/api-docs/types/graph-object-snapshot-info.html) | 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`](https://wartiva.com/api-docs/types/endpoint-user.html) | The [EndpointUser](https://wartiva.com/api-docs/types/endpoint-user.html) these settings apply to. |
| `osSpecific` - [`UserSystemSettingsOsSpecific`](https://wartiva.com/api-docs/types/user-system-settings-os-specific.html) | The platform-specific per-user settings. Currently always [UserSystemSettingsMacOS](https://wartiva.com/api-docs/types/user-system-settings-mac-os.html). |
| `findings` - [`FindingsPayload!`](https://wartiva.com/api-docs/types/findings-payload.html) | Policy findings for this object. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `issues` - [`IssuesPayload!`](https://wartiva.com/api-docs/types/issues-payload.html) | Policy issues for this object. |
| Arguments `limit` - [`Int`](https://wartiva.com/api-docs/types/int.html) Maximum number of results to return. `skip` - [`Int`](https://wartiva.com/api-docs/types/int.html) Number of results to skip. |
| `issuesSummary` - [`IssuesSummary!`](https://wartiva.com/api-docs/types/issues-summary.html) | Summary of the active policy issues currently open on this object, broken down by severity. |

## Returned by

- [`userSystemSettings`](https://wartiva.com/api-docs/queries/user-system-settings.html) query: Retrieves one macOS user's UserSystemSettings by its graph object id: screen saver locking, Universal Control, Siri and search data sharing,…

## Used by

- [`EndpointUser`](https://wartiva.com/api-docs/types/endpoint-user.html) type: An operating system or domain user account observed on an Endpoint.
- [`GraphObjectType`](https://wartiva.com/api-docs/types/graph-object-type.html) enum: An enumeration of the different types of security graph objects.
- [`GraphObjectTypeCategory`](https://wartiva.com/api-docs/types/graph-object-type-category.html) enum: High-level grouping used to organize GraphObjectType values in UI navigation and API discovery.
- [`UserSystemSettingsPayload`](https://wartiva.com/api-docs/types/user-system-settings-payload.html) type: Payload wrapper for a single UserSystemSettings result.

## Related types

- [`EndpointUser`](https://wartiva.com/api-docs/types/endpoint-user.html) An operating system or domain user account observed on an Endpoint.

## Example

### Example

```json
{
  "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
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt