All pages
Powered by GitBook
1 of 2

Loading...

Loading...

Windows Device Groups

Inbound Port

List

get

Retrieve a list of Windows device groups.

Query parameters
siteIdinteger · int32Optional

Site ID for which to retrieve the Windows device group (optional).

NamestringOptional

Filter the result by Windows device group name (optional).

Responses
200

Success

application/json; api-version=1.0
401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
get
/api/WinDeviceGroup

Create

post

Create a new Windows device group.

Body

Create a new Windows Device Group

namestring | nullableRequired

Name of the new Windows Device Group.

descriptionstring | nullableOptional

Description of the new Windows Device Group.

Responses
201

Created

application/json; api-version=1.0
401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
post
/api/WinDeviceGroup

Get

get

Retrieve a specific Windows device group by ID.

Path parameters
idinteger · int32Required

Windows device group Id

Responses
200

Success

application/json; api-version=1.0
401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
get
/api/WinDeviceGroup/{id}

Update

put

Update Windows device group settings.

Path parameters
idinteger · int32Required

Windows device group ID.

Body

Modify a Windows Device Group

displayNamestring | nullableOptional

Modify the description of the Windows Device Group.

descriptionstring | nullableOptional

Modify the description of the Windows Device Group.

enabledboolean | nullableOptional

Enable or disable the Windows Device Group.

disableRemovableDrivesboolean | nullableOptional

Enable or disable Removeable Drives.

disablePrintScreenboolean | nullableOptional

Enable or disable Print Screens.

replaceDesktopboolean | nullableOptional

Enable or disable the Replace Desktop option.

kioskModeboolean | nullableOptional

Enable or disable Kiosk Mode.

useClientAsDesktopboolean | nullableOptional

Enable or disable the Client As Desktop option.

adminModePasswordstring | nullableOptional

The Admin Mode Passoword.

enableFirewallboolean | nullableOptional

Enable or disable Firewall option.

requestAuthorizationboolean | nullableOptional

Enable or disable the Request Authorization option.

Responses
204

No Content

401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
put
/api/WinDeviceGroup/{id}

No content

Delete

delete

Delete a Windows device group by ID.

Path parameters
idinteger · int32Required
Responses
204

No Content

401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
delete
/api/WinDeviceGroup/{id}

No content

Get

get

Retrieve a Windows device group's Inbound ports by ID.

Path parameters
idinteger · int32Required

Windows device group Id

Responses
200

Success

application/json; api-version=1.0
401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
get
/api/WinDeviceGroup/{id}/InboundPort

Add

post

Add an Inbound port to a Windows device group by ID.

Path parameters
idinteger · int32Required

Windows device group Id

Body

Add an Inbound Port to a Windows Device Group

portinteger · int32Required

The Port to add to the windows device group.

protocolstring · enumRequired

Connection Protocol type.

Possible values:
profilestring[Flag] · enumRequired

Profile Setting.

Possible values:
Responses
201

Created

401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
post
/api/WinDeviceGroup/{id}/InboundPort

No content

Remove

delete

Remove an Inbound port from a Windows device group by ID.

Path parameters
idinteger · int32Required

Windows device group Id

Body

Remove an Inbound Port from a Windows Device Group

portinteger · int32Required

The Port of the Windows Device Group to remove.

protocolstring · enumRequired

Connection Protocol type.

Possible values:
profilestring[Flag] · enumRequired

Profile Setting.

Possible values:
Responses
204

No Content

401

Unauthorized

application/json; api-version=1.0
404

Not Found

application/json; api-version=1.0
delete
/api/WinDeviceGroup/{id}/InboundPort

No content

GET /api/WinDeviceGroup HTTP/1.1
Host: 
Accept: */*
[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-12-09T02:38:09.984Z",
    "timeLastMod": "2025-12-09T02:38:09.984Z",
    "siteId": 1,
    "name": "text",
    "description": "text",
    "disableRemovableDrives": true,
    "disablePrintScreen": true,
    "replaceDesktop": true,
    "kioskMode": true,
    "useClientAsDesktop": true,
    "enableFirewall": true,
    "inboundPorts": [
      {
        "port": 1,
        "protocol": [
          "0 = TCP",
          "1 = UDP"
        ],
        "profile": [
          "1 = Domain",
          "2 = Private",
          "4 = Public",
          "2147483647 = All"
        ]
      }
    ],
    "requestAuthorization": true
  }
]
POST /api/WinDeviceGroup HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 36

{
  "name": "text",
  "description": "text"
}
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-12-09T02:38:09.984Z",
  "timeLastMod": "2025-12-09T02:38:09.984Z",
  "siteId": 1,
  "name": "text",
  "description": "text",
  "disableRemovableDrives": true,
  "disablePrintScreen": true,
  "replaceDesktop": true,
  "kioskMode": true,
  "useClientAsDesktop": true,
  "enableFirewall": true,
  "inboundPorts": [
    {
      "port": 1,
      "protocol": [
        "0 = TCP",
        "1 = UDP"
      ],
      "profile": [
        "1 = Domain",
        "2 = Private",
        "4 = Public",
        "2147483647 = All"
      ]
    }
  ],
  "requestAuthorization": true
}
GET /api/WinDeviceGroup/{id} HTTP/1.1
Host: 
Accept: */*
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-12-09T02:38:09.984Z",
  "timeLastMod": "2025-12-09T02:38:09.984Z",
  "siteId": 1,
  "name": "text",
  "description": "text",
  "disableRemovableDrives": true,
  "disablePrintScreen": true,
  "replaceDesktop": true,
  "kioskMode": true,
  "useClientAsDesktop": true,
  "enableFirewall": true,
  "inboundPorts": [
    {
      "port": 1,
      "protocol": [
        "0 = TCP",
        "1 = UDP"
      ],
      "profile": [
        "1 = Domain",
        "2 = Private",
        "4 = Public",
        "2147483647 = All"
      ]
    }
  ],
  "requestAuthorization": true
}
PUT /api/WinDeviceGroup/{id} HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 256

{
  "displayName": "text",
  "description": "text",
  "enabled": true,
  "disableRemovableDrives": true,
  "disablePrintScreen": true,
  "replaceDesktop": true,
  "kioskMode": true,
  "useClientAsDesktop": true,
  "adminModePassword": "text",
  "enableFirewall": true,
  "requestAuthorization": true
}
DELETE /api/WinDeviceGroup/{id} HTTP/1.1
Host: 
Accept: */*
GET /api/WinDeviceGroup/{id}/InboundPort HTTP/1.1
Host: 
Accept: */*
[
  {
    "port": 1,
    "protocol": [
      "0 = TCP",
      "1 = UDP"
    ],
    "profile": [
      "1 = Domain",
      "2 = Private",
      "4 = Public",
      "2147483647 = All"
    ]
  }
]
POST /api/WinDeviceGroup/{id}/InboundPort HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 114

{
  "port": 1,
  "protocol": [
    "0 = TCP",
    "1 = UDP"
  ],
  "profile": [
    "1 = Domain",
    "2 = Private",
    "4 = Public",
    "2147483647 = All"
  ]
}
DELETE /api/WinDeviceGroup/{id}/InboundPort HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 114

{
  "port": 1,
  "protocol": [
    "0 = TCP",
    "1 = UDP"
  ],
  "profile": [
    "1 = Domain",
    "2 = Private",
    "4 = Public",
    "2147483647 = All"
  ]
}