Local | Parallels REST API

Parallels REST API

Products Support Partners Documentation

Delete

delete

Delete a published application from a site.

Path parameters

idinteger · int32required

ID of the published Local application to be deleted

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request DELETE \
  --url '/api/PubItems/{id}/Apps/Local'

204

401

404

No Content

List

get

Retrieve a list of all the published Local applications

Query parameters

SiteIdinteger · int32optional

Site ID for which to retrieve all the published Local applications (optional)

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/api/PubItems/Apps/Local'

200

401

404

[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-04-06T01:33:22.303Z",
    "timeLastMod": "2025-04-06T01:33:22.303Z",
    "name": "text",
    "type": [
      "0 = Any",
      "1 = Folder",
      "2 = RDSApp",
      "3 = RDSDesktop",
      "4 = VDIDesktop",
      "5 = PCDesktop",
      "6 = PCApp",
      "7 = VDIApp",
      "8 = AVDApp",
      "9 = AVDDesktop",
      "10 = LocalApp"
    ],
    "parentId": 1,
    "previousId": 1,
    "description": "text",
    "enabledMode": [
      "0 = Disabled",
      "1 = Enabled",
      "2 = Maintenance"
    ],
    "enabled": true,
    "publishToSite": [
      1
    ],
    "filter": {
      "rules": [
        {
          "id": 1,
          "priority": 1,
          "enabled": true,
          "name": "text",
          "description": "text",
          "criteria": {
            "securityPrincipals": {
              "enabled": true,
              "matchingMode": [
                "0 = IsNotOneOfTheFollowing",
                "1 = IsOneOfTheFollowing"
              ],
              "members": [
                {
                  "account": "text",
                  "type": [
                    "1 = User",
                    "2 = Group",
                    "3 = ForeignSecurityPrincipal",
                    "4 = Computer"
                  ],
                  "sid": "text"
                }
              ]
            },
            "gateways": {
              "enabled": true,
              "matchingMode": [
                "0 = IsNotOneOfTheFollowing",
                "1 = IsOneOfTheFollowing"
              ],
              "members": [
                {
                  "gatewayIP": "text"
                }
              ]
            },
            "oSs": {
              "enabled": true,
              "matchingMode": [
                "0 = IsNotOneOfTheFollowing",
                "1 = IsOneOfTheFollowing"
              ],
              "allowedOSes": {
                "chrome": true,
                "android": true,
                "webClient": true,
                "iOS": true,
                "linux": true,
                "mac": true,
                "wyse": true,
                "windows": true
              }
            },
            "iPs": {
              "enabled": true,
              "matchingMode": [
                "0 = IsNotOneOfTheFollowing",
                "1 = IsOneOfTheFollowing"
              ],
              "allowedIPs": {
                "iPv4s": [
                  {
                    "from": "text",
                    "to": "text"
                  }
                ],
                "iPv6s": [
                  {
                    "from": "text",
                    "to": "text"
                  }
                ]
              }
            },
            "hardwareIDs": {
              "enabled": true,
              "matchingMode": [
                "0 = IsNotOneOfTheFollowing",
                "1 = IsOneOfTheFollowing"
              ],
              "members": [
                {
                  "hardwareID": "text"
                }
              ]
            },
            "access": [
              "0 = DenyCriteriaWhen",
              "1 = AllowCriteriaWhen"
            ],
            "devices": {
              "enabled": true,
              "matchingMode": [
                "0 = IsNotOneOfTheFollowing",
                "1 = IsOneOfTheFollowing"
              ],
              "members": [
                {
                  "client": "text"
                }
              ]
            },
            "themes": {
              "enabled": true,
              "matchingMode": [
                "0 = IsNotOneOfTheFollowing",
                "1 = IsOneOfTheFollowing"
              ],
              "ids": [
                1
              ]
            }
          }
        }
      ],
      "default": [
        "0 = Deny",
        "1 = Allow"
      ]
    },
    "startOnLogon": true,
    "inheritShortcutDefaultSettings": true,
    "createShortcutOnDesktop": true,
    "createShortcutInStartFolder": true,
    "startPath": "text",
    "createShortcutInStartUpFolder": true,
    "replicateShortcutSettings": true,
    "url": "text",
    "windows": {
      "enabled": true,
      "useIfAvailable": true,
      "target": "text",
      "startIn": "text",
      "parameters": "text",
      "winType": [
        "0 = Normal",
        "1 = Maximized",
        "2 = Minimized"
      ]
    },
    "mac": {
      "enabled": true
    },
    "linux": {
      "enabled": true
    },
    "iOS": {
      "enabled": true
    },
    "android": {
      "enabled": true
    },
    "userPortal": {
      "enabled": true
    },
    "replicateLocalAppSettings": true
  }
]

Create

post

Add a published Local application to a site.

Body

Create a new published local application

namestring | nullablerequired

Published resource name.

parentIdinteger · int32 | nullableoptional

Parent publishing folder ID.

previousIdinteger · int32 | nullableoptional

Previous published ID.

enabledModestring · enumoptional

Published resource availability modes.

Available options:

descriptionstring | nullableoptional

Published resource description.

publishToSiteIdsinteger · int32[] | nullableoptional

An array of Sites IDs to which to publish a resource.

siteIdinteger · int32optional

Site ID in which to publish the specified Item. If the parameter is omitted, the site ID of the Licensing Server will be used.

urlstring | nullableoptional

URL.

windowsEnabledboolean | nullableoptional

Windows: Whether the application is enabled for the operating system or not.

windowsUseIfAvailableboolean | nullableoptional

Windows: Use the following application if available on local device.

windowsStartInstring | nullableoptional

Windows: Application working directory.

windowsTargetstring | nullableoptional

Windows: Application target file. (i.e. calc.exe, file.txt, etc.).

windowsParametersstring | nullableoptional

Windows: Application parameters.

windowsWinTypestring · enumoptional

Published application window type

Available options:

macEnabledboolean | nullableoptional

Mac: Whether the application is enabled for the operating system or not.

linuxEnabledboolean | nullableoptional

Linux: Whether the application is enabled for the operating system or not.

iOSEnabledboolean | nullableoptional

iOS: Whether the application is enabled for the operating system or not.

androidEnabledboolean | nullableoptional

Android: Whether the application is enabled for the operating system or not.

userPortalEnabledboolean | nullableoptional

UserPortal: Whether the application is enabled for the operating system or not.

replicateLocalAppSettingsboolean | nullableoptional

Whether to replicate local application settings or not.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/api/PubItems/Apps/Local' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "name": "text",
    "parentId": 1,
    "previousId": 1,
    "enabledMode": [
      "0 = Disabled",
      "1 = Enabled",
      "2 = Maintenance"
    ],
    "description": "text",
    "publishToSiteIds": [
      1
    ],
    "siteId": 1,
    "url": "text",
    "windowsEnabled": true,
    "windowsUseIfAvailable": true,
    "windowsStartIn": "text",
    "windowsTarget": "text",
    "windowsParameters": "text",
    "windowsWinType": [
      "0 = Normal",
      "1 = Maximized",
      "2 = Minimized"
    ],
    "macEnabled": true,
    "linuxEnabled": true,
    "iOSEnabled": true,
    "androidEnabled": true,
    "userPortalEnabled": true,
    "replicateLocalAppSettings": true
  }'

201

401

409

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-04-06T01:33:22.303Z",
  "timeLastMod": "2025-04-06T01:33:22.303Z",
  "name": "text",
  "type": [
    "0 = Any",
    "1 = Folder",
    "2 = RDSApp",
    "3 = RDSDesktop",
    "4 = VDIDesktop",
    "5 = PCDesktop",
    "6 = PCApp",
    "7 = VDIApp",
    "8 = AVDApp",
    "9 = AVDDesktop",
    "10 = LocalApp"
  ],
  "parentId": 1,
  "previousId": 1,
  "description": "text",
  "enabledMode": [
    "0 = Disabled",
    "1 = Enabled",
    "2 = Maintenance"
  ],
  "enabled": true,
  "publishToSite": [
    1
  ],
  "filter": {
    "rules": [
      {
        "id": 1,
        "priority": 1,
        "enabled": true,
        "name": "text",
        "description": "text",
        "criteria": {
          "securityPrincipals": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "account": "text",
                "type": [
                  "1 = User",
                  "2 = Group",
                  "3 = ForeignSecurityPrincipal",
                  "4 = Computer"
                ],
                "sid": "text"
              }
            ]
          },
          "gateways": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "gatewayIP": "text"
              }
            ]
          },
          "oSs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedOSes": {
              "chrome": true,
              "android": true,
              "webClient": true,
              "iOS": true,
              "linux": true,
              "mac": true,
              "wyse": true,
              "windows": true
            }
          },
          "iPs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "allowedIPs": {
              "iPv4s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ],
              "iPv6s": [
                {
                  "from": "text",
                  "to": "text"
                }
              ]
            }
          },
          "hardwareIDs": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "hardwareID": "text"
              }
            ]
          },
          "access": [
            "0 = DenyCriteriaWhen",
            "1 = AllowCriteriaWhen"
          ],
          "devices": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "members": [
              {
                "client": "text"
              }
            ]
          },
          "themes": {
            "enabled": true,
            "matchingMode": [
              "0 = IsNotOneOfTheFollowing",
              "1 = IsOneOfTheFollowing"
            ],
            "ids": [
              1
            ]
          }
        }
      }
    ],
    "default": [
      "0 = Deny",
      "1 = Allow"
    ]
  },
  "startOnLogon": true,
  "inheritShortcutDefaultSettings": true,
  "createShortcutOnDesktop": true,
  "createShortcutInStartFolder": true,
  "startPath": "text",
  "createShortcutInStartUpFolder": true,
  "replicateShortcutSettings": true,
  "url": "text",
  "windows": {
    "enabled": true,
    "useIfAvailable": true,
    "target": "text",
    "startIn": "text",
    "parameters": "text",
    "winType": [
      "0 = Normal",
      "1 = Maximized",
      "2 = Minimized"
    ]
  },
  "mac": {
    "enabled": true
  },
  "linux": {
    "enabled": true
  },
  "iOS": {
    "enabled": true
  },
  "android": {
    "enabled": true
  },
  "userPortal": {
    "enabled": true
  },
  "replicateLocalAppSettings": true
}

Created

Update

put

Modify properties of a published Local application.

Path parameters

idinteger · int32required

ID of the published Local application to be updated

Body

Update settings of a local application

namestring | nullableoptional

A new name to assign to the published resource.

enabledModestring · enumoptional

Published resource availability modes.

Available options:

descriptionstring | nullableoptional

Published resource description.

publishToSiteIdsinteger · int32[] | nullableoptional

An array of sites to which to publish a resource.

preferredRoutingEnabledboolean | nullableoptional

Enable or disable Preferred Routing.

replicateShortcutSettingsboolean | nullableoptional

Replicate shortcut settings to all sites.

createShortcutOnDesktopboolean | nullableoptional

Create a shortcut on a client's desktop.

createShortcutInStartFolderboolean | nullableoptional

Create a shortcut in the client's Start folder.

createShortcutInStartUpFolderboolean | nullableoptional

Create a shortcut in the client's Auto Start folder.

startPathstring | nullableoptional

Specifies the path in the Start folder where the shortcut will be created.

inheritShortcutDefaultSettingsboolean | nullableoptional

Inherit default shortcut settings.

startOnLogonboolean | nullableoptional

Start a resource automatically when a user logs on.

excludePrelaunchboolean | nullableoptional

Exclude application from prelaunch.

urlstring | nullableoptional

URL.

windowsEnabledboolean | nullableoptional

Windows: Whether the application is enabled for the operating system or not.

windowsUseIfAvailableboolean | nullableoptional

Windows: Use the following application if available on local device.

windowsStartInstring | nullableoptional

Windows: Application working directory.

windowsTargetstring | nullableoptional

Windows: Application target file. (i.e. calc.exe, file.txt, etc.).

windowsParametersstring | nullableoptional

Windows: Application parameters.

windowsWinTypestring · enumoptional

Published application window type

Available options:

macEnabledboolean | nullableoptional

Mac: Whether the application is enabled for the operating system or not.

linuxEnabledboolean | nullableoptional

Linux: Whether the application is enabled for the operating system or not.

iOSEnabledboolean | nullableoptional

iOS: Whether the application is enabled for the operating system or not.

androidEnabledboolean | nullableoptional

Android: Whether the application is enabled for the operating system or not.

userPortalEnabledboolean | nullableoptional

UserPortal: Whether the application is enabled for the operating system or not.

replicateLocalAppSettingsboolean | nullableoptional

Whether to replicate local application settings or not.

Responses

application/json; api-version=1.0

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/api/PubItems/{id}/Apps/Local' \
  --header 'Content-Type: application/json; api-version=1.0' \
  --data '{
    "name": "text",
    "enabledMode": [
      "0 = Disabled",
      "1 = Enabled",
      "2 = Maintenance"
    ],
    "description": "text",
    "publishToSiteIds": [
      1
    ],
    "preferredRoutingEnabled": true,
    "replicateShortcutSettings": true,
    "createShortcutOnDesktop": true,
    "createShortcutInStartFolder": true,
    "createShortcutInStartUpFolder": true,
    "startPath": "text",
    "inheritShortcutDefaultSettings": true,
    "startOnLogon": true,
    "excludePrelaunch": true,
    "url": "text",
    "windowsEnabled": true,
    "windowsUseIfAvailable": true,
    "windowsStartIn": "text",
    "windowsTarget": "text",
    "windowsParameters": "text",
    "windowsWinType": [
      "0 = Normal",
      "1 = Maximized",
      "2 = Minimized"
    ],
    "macEnabled": true,
    "linuxEnabled": true,
    "iOSEnabled": true,
    "androidEnabled": true,
    "userPortalEnabled": true,
    "replicateLocalAppSettings": true
  }'

204

401

404

No Content