---
title: "POST /api/v1/target-assignments/migrate-to-superseding-assignment-what-if"
method: POST
path: "/api/v1/target-assignments/migrate-to-superseding-assignment-what-if"
tags: ["TargetAssignments"]
---

# POST /api/v1/target-assignments/migrate-to-superseding-assignment-what-if

`POST /api/v1/target-assignments/migrate-to-superseding-assignment-what-if`

## 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/migrate-to-superseding-assignment-what-if`
- Auth: none declared

## Request body

- MigrateToSupersedingAssignmentRequest
  - `oldAssignmentId` integer
  - `newTaskId` integer
  - `newTaskType` 'Global' | 'Local': The string or integer value may be used. Global = 0, Local = 1

## Response `200`

OK

- MigrateToSupersedingAssignmentWhatIfResponseOpResult
  - `isSuccess` boolean
  - `reason` string, nullable
  - `value` MigrateToSupersedingAssignmentWhatIfResponse
    - `isNew` boolean
    - `assignment` LocalTargetAssignmentResource
      - `targetText` string, nullable
      - `targetTypeName` string, nullable
      - `targetScopeName` string, nullable
      - `targetMissing` boolean
      - `tenantMissing` boolean
      - `targetTypeMissing` boolean
      - `targetTypeDescription` string, nullable
      - `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
      - `onboardingOnly` boolean
      - `target` string, nullable
      - `targetCategory` 'Computer' | 'Tenant' | 'Person': The string or integer value may be used. Computer = 0, Tenant = 1, Person = 2
      - `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
      - `tenantId` integer, nullable
      - `propagateToChildTenants` boolean
      - `allowAccessToParentTenant` boolean
      - `providerLinkId` integer, nullable
      - `providerClientGroupType` string, uuid, nullable
      - `providerDeviceGroupType` string, uuid, nullable
      - `targetGroupFilterName` string, nullable
      - `id` integer
      - `isCore` boolean
      - `excluded` boolean
      - `targetEnforcement` 'Required' | 'Optional' | 'Adhoc' | 'Onboarding': The string or integer value may be used. Required = 1, Optional = 2, Adhoc = 3, Onboarding = 4
      - `notes` string, nullable
      - `notesUpdatedByUserName` string, nullable
      - `notesUpdatedUtc` string, date-time, nullable
      - `maintenanceType` 'GlobalSoftware' | 'LocalSoftware' | 'WindowsUpdate' | 'ChocolateySoftware' | 'NiniteSoftware' | 'LocalMaintenanceTask' | 'GlobalMaintenanceTask' | 'AgentUpdate': The string or integer value may be used. GlobalSoftware = 0, LocalSoftware = 1, WindowsUpdate = 2, ChocolateySoftware = 3, NiniteSoftware = 4, LocalMaintenanceTask = 5, GlobalMaintenanceTask = 6, AgentUpdate = 7
      - `maintenanceIdentifier` string, nullable, required
      - `targetName` string, nullable
      - `softwareSemanticVersion` SemanticVersion
        - `major` integer
        - `minor` integer
        - `patch` integer
        - `releaseLabels` string[], nullable
        - `release` string, nullable
        - `isPrerelease` boolean
        - `hasMetadata` boolean
        - `metadata` string, nullable
      - `softwareSemanticVersionString` string, nullable
      - `desiredSoftwareState` 'NewerOrEqualVersion' | 'NotPresent' | 'AnyVersion' | 'ThisVersion' | 'OlderOrEqualVersion' | 'LatestVersion' | 'NoAction' | 'UpdateIfFound': The string or integer value may be used. NewerOrEqualVersion = 0, NotPresent = 1, AnyVersion = 2, ThisVersion = 3, OlderOrEqualVersion = 4, LatestVersion = 5, NoAction = 6, UpdateIfFound = 7
      - `softwareProviderType` 'Ninite' | 'Chocolatey' | 'Inherent': The string or integer value may be used. Ninite = 1, Chocolatey = 2, Inherent = 3
      - `licenseId` integer, nullable
      - `licenseName` string, nullable
      - `updatedDateUTC` string, date-time
      - `updatedBy` string, nullable
      - `createdDateUTC` string, date-time
      - `maintenanceTaskMode` 'Enforce' | 'Audit' | 'Monitor' | 'NoAction': The string or integer value may be used. Enforce = 0, Audit = 1, Monitor = 2, NoAction = 3
      - `taskParameterValues` object, nullable
      - `sortOrder` integer
      - `integrationTypeId` string, nullable
      - `integrationPrompt` string, nullable
      - `providerLinkIdForMaintenanceItem` integer, nullable
      - `targetVisibility` TargetAssignmentVisibilityResource
        - `selfService` boolean
        - `technicianPod` boolean
      - `databaseType` 'Global' | 'Local': The string or integer value may be used. Global = 0, Local = 1
    - `policyDescription` string, nullable

---

[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)