---
title: "POST /api/v1/target-assignments/target-preview"
method: POST
path: "/api/v1/target-assignments/target-preview"
tags: ["TargetAssignments"]
---

# POST /api/v1/target-assignments/target-preview

`POST /api/v1/target-assignments/target-preview`

## Request

- Base URL: `https://api.immy.bot` (the document declares no server; this is the origin it was published from)
- URL: `https://api.immy.bot/api/v1/target-assignments/target-preview`
- Auth: none declared

## Request body

- CalculateTargetsRequest
  - `targetType` 'All' | 'Computer' | 'Metascript' | 'Person' | 'AzureGroup' | 'TenantMetascript' | 'AllForTenant' | 'ProviderDeviceGroup' | 'ProviderClientGroup' | 'TenantFilterScript' | 'FilterScript' | 'AllTenants' | 'SpecificTenant' | 'Tag' | 'TenantTag' | 'CloudTag' | 'CloudProviderClientGroup': The string or integer value may be used. All = 1, Computer = 2, Metascript = 5, Person = 7, AzureGroup = 8, TenantMetascript = 20, AllForTenant = 21, ProviderDeviceGroup = 22, ProviderClientGroup = 23, TenantFilterScript = 24, FilterScript = 25, AllTenants = 28, SpecificTenant = 29, Tag = 30, TenantTag = 31, CloudTag = 40, CloudProviderClientGroup = 42
  - `target` string, nullable
  - `providerLinkId` integer, nullable
  - `onboardingOnly` boolean
  - `targetGroupFilter` 'All' | 'Servers' | 'Workstations' | 'PortableDevices' | 'WorkstationsAndPortableDevices' | 'DomainControllers' | 'PrimaryDomainControllers': The string or integer value may be used. All = 0, Servers = 1, Workstations = 2, PortableDevices = 3, WorkstationsAndPortableDevices = 4, DomainControllers = 5, PrimaryDomainControllers = 6
  - `providerDeviceGroupType` string, uuid, nullable
  - `providerClientGroupType` string, uuid, nullable
  - `tenantId` integer, nullable
  - `propagateToChildTenants` boolean
  - `allowAccessToParentTenant` boolean

## Response `200`

OK

- CalculateTargetedComputerResponse
  - `targetedComputers` CalculateTargetedComputer[], nullable
    - `id` integer
    - `cn` string, nullable
    - `on` boolean
    - `tn` string, nullable
    - `ppi` integer, nullable
    - `ppn` string, nullable
    - `ti` integer
    - `os` string, nullable
    - `obs` 'NeedsOnboarding' | 'Onboarding' | 'Onboarded': The string or integer value may be used. NeedsOnboarding = 0, Onboarding = 1, Onboarded = 2
    - `sn` string, nullable
    - `dr` integer, nullable
    - `sb` boolean
    - `ct` integer[], nullable
  - `hasUnauthorizedComputers` boolean

---

[API](https://skmtc.dev/immy/apis/immy-bot-api-2.md) · [All operations](https://skmtc.dev/immy/apis/immy-bot-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/immy/apis/immy-bot-api-2/revisions/75b50268fa51?raw)