Submitting a Task Sequence / OSD Request

This section describes the App Broker REST API endpoint to submit a task sequence/OSD request to App Portal..

Endpoint Example	Response Body Example
\[POST\] http://<SERVERNAME>/esd/api/servicenow/requests/SN1001?dn=appportal&un=spatel&dev= itaapccnet01

{
  "requestId": "0",
  "appPortalOrder": {
    "targets": [
      {
        "uniqueUserName": "APPPORTAL\\spatel",
        "machineName": "NuMacSat01",
        "catalogs": [
          {
            "id": 14,
            "reservationId": 0
          }
        ]
      }
    ],
    "RolesAndApps": [
      {
        "RoleId": "1",
        "MigrationType": "1",
        "CatalogIdsSelectedForMigrateAndInstall": "1,2,3",
        "ProcessBothInserts": "true",
        "CreateAssociation": "false",
        "OldMachineName": "chedev01",
        "OsdBuildId": "xyztxt",
        "MacAddr": "12:34:56:78:98:76"
      }
    ]
  }
}

Input Parameter Details

The following are the details for the parameters listed in the Request Body Example:

Parameter	Description
RequestId	Can be any string.
UniqueUserName	Unique name for the target user.
Machine	Target machine where the task sequence / OSD should be deployed.
Catalogs	The catalog item for which the request is being made.
RoleId	The role that is applicable to the target user.
MigrationType	Possible values are: 1 —In-place migration 2 —Side by side migration 3 —No data migration Option 3, no data migration, is already handled in different scenarios from Employee App Provisioning in ServiceNow.
CatalogIdsSelectedForMigrateAndInstall	IDs of catalog items that are part of role, selected as part of migratable apps and additional apps.
ProcessBothInserts	Insert both source machine and target machine into collection.
CreateAssociation	Create association between source and target computers.
OldMachineName	Name of the old or source computer.
OsdBuildId	Build ID with 6-character-long string
MacAddr	MAC address of the target computer.

Output Details

The output gives HTTP status 200.