---
title: SoftwareUpdatePreferences type | Wartiva GraphQL API
description: The operating system update configuration of an Endpoint and the updates currently available to it. Wartiva GraphQL API reference with examples.
url: https://wartiva.com/api-docs/types/software-update-preferences.html
updated: 2026-10-07
---

Applications and updates · GraphQL type

# `SoftwareUpdatePreferences` type

The operating system update configuration of an [Endpoint](https://wartiva.com/api-docs/types/endpoint.html) and the updates currently available to it. Collected on Windows and macOS: on Windows it records whether the Automatic Updates service is functional, the Automatic Updates settings (notification level, scheduled install day and hour), the last successful search and install times, and each pending update with its KB article IDs and MSRC severity, in [SoftwareUpdatePreferencesWindows](https://wartiva.com/api-docs/types/software-update-preferences-windows.html); on macOS it records the automatic download and install preferences, any enforced update deferral, the last successful update check and the recommended updates, in [SoftwareUpdatePreferencesMacOS](https://wartiva.com/api-docs/types/software-update-preferences-mac-os.html). Each Endpoint has at most one SoftwareUpdatePreferences, reachable from the Endpoint's `softwareUpdatePreferences` field.

## Fields

| Field Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The SoftwareUpdatePreferences' 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. |
| `seen` - [`SeenOnline!`](https://wartiva.com/api-docs/types/seen-online.html) | Describes when this SoftwareUpdatePreferences was seen. |
| `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. |
| `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. |
| `endpoint` - [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) | The Endpoint this SoftwareUpdatePreferences belongs to if available. |
| `osSpecific` - [`SoftwareUpdatePreferencesOsSpecific`](https://wartiva.com/api-docs/types/software-update-preferences-os-specific.html) | The platform-specific update settings and available updates: [SoftwareUpdatePreferencesWindows](https://wartiva.com/api-docs/types/software-update-preferences-windows.html) on Windows or [SoftwareUpdatePreferencesMacOS](https://wartiva.com/api-docs/types/software-update-preferences-mac-os.html) on macOS. |
| `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

- [`softwareUpdatePreferences`](https://wartiva.com/api-docs/queries/software-update-preferences.html) query: Retrieves an endpoint's SoftwareUpdatePreferences by its graph object id: the operating system update configuration and the updates currently…

## Used by

- [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) type: A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.
- [`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.
- [`ProprietaryCheckId`](https://wartiva.com/api-docs/types/proprietary-check-id.html) enum: A check that ships with the platform, run by a PROPRIETARY rule on its Schedule.
- [`SoftwareUpdatePreferencesPayload`](https://wartiva.com/api-docs/types/software-update-preferences-payload.html) type: Payload wrapper for a single SoftwareUpdatePreferences result.

## Related types

- [`Endpoint`](https://wartiva.com/api-docs/types/endpoint.html) A Windows, macOS, or Linux computer that runs the Wartiva endpoint agent and is enrolled with an organization.

## Example

### Example

```json
{
  "id": 4,
  "orgId": "615f3b3b28284380e28a7342",
  "seen": SeenOnline,
  "objectType": "ACCOUNT_POLICY",
  "objectTypeLabel": "abc123",
  "displayName": "abc123",
  "firstSeen": "2021-10-07T18:23:25.829Z",
  "lastSeen": "2021-10-07T18:23:25.829Z",
  "createdAt": "2021-10-07T18:23:25.829Z",
  "updatedAt": "2021-10-07T18:23:25.829Z",
  "snapshotInfo": GraphObjectSnapshotInfo,
  "endpoint": Endpoint,
  "osSpecific": SoftwareUpdatePreferencesMacOS,
  "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