---
title: applicationInstallUserSettings query | Wartiva GraphQL API
description: Retrieves an ApplicationInstallUserSettings by its graph object id: one user's settings for a supported macOS application install.
url: https://wartiva.com/api-docs/queries/application-install-user-settings.html
updated: 2026-10-07
---

Applications and updates · GraphQL query

# `applicationInstallUserSettings` query

Retrieves an [ApplicationInstallUserSettings](https://wartiva.com/api-docs/types/application-install-user-settings.html) by its graph object id: one user's settings for a supported macOS application install (Safari, Terminal, or Finder). At most one exists per install and user, reachable through the [ApplicationInstall](https://wartiva.com/api-docs/types/application-install.html)'s `userSettings` field or the [EndpointUser](https://wartiva.com/api-docs/types/endpoint-user.html)'s `applicationInstallUserSettings` field; find them across endpoints with [graphSearch](https://wartiva.com/api-docs/queries/graph-search.html) on the APPLICATION_INSTALL_USER_SETTINGS object type. Returns a not-found error when no object has the id, and an error when the id belongs to another object type.

## Response

Returns an [`ApplicationInstallUserSettingsPayload!`](https://wartiva.com/api-docs/types/application-install-user-settings-payload.html)

## Arguments

| Name | Description |
|---|---|
| `id` - [`ID!`](https://wartiva.com/api-docs/types/id.html) | The ApplicationInstallUserSettings identifier. |
| `mockOptions` - [`MockDataInput`](https://wartiva.com/api-docs/types/mock-data-input.html) | Options for mock data generation. Options supported: key: "PLATFORM", value: OsPlatform |

## Example

### Query

```graphql
query applicationInstallUserSettings(
  $id: ID!,
  $mockOptions: MockDataInput
) {
  applicationInstallUserSettings(
    id: $id,
    mockOptions: $mockOptions
  ) {
    node {
      id
      orgId
      objectType
      objectTypeLabel
      displayName
      firstSeen
      lastSeen
      seen {
        ...SeenOnlineFragment
      }
      createdAt
      updatedAt
      snapshotInfo {
        ...GraphObjectSnapshotInfoFragment
      }
      applicationInstall {
        ...ApplicationInstallFragment
      }
      endpointUser {
        ...EndpointUserFragment
      }
      settings {
        ... on SafariSettingsMacOS {
          ...SafariSettingsMacOSFragment
        }
        ... on TerminalSettingsMacOS {
          ...TerminalSettingsMacOSFragment
        }
        ... on FinderSettingsMacOS {
          ...FinderSettingsMacOSFragment
        }
      }
      findings {
        ...FindingsPayloadFragment
      }
      issues {
        ...IssuesPayloadFragment
      }
      issuesSummary {
        ...IssuesSummaryFragment
      }
    }
  }
}

```

### Variables

```json
{"id": 4, "mockOptions": MockDataInput}

```

### Response

```json
{
  "data": {
    "applicationInstallUserSettings": {
      "node": ApplicationInstallUserSettings
    }
  }
}

```

---

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