Skip to main content

createCustomGroup

This method creates a new custom group of endpoints.

Services

This method requires you to place the {service} name in the API URL. The allowed services are:

  • computers, for "Computers and Virtual Machines"

  • virtualmachines, for "Virtual Machines"

For example, the request URL for the virtual machines service is:

https://YOUR-HOSTNAME/api/v1.0/jsonrpc/network/virtualmachines

Parameters

Parameter

Type

Optional

Description

groupName

String

No

The name for the new group

parentId

String

Yes

The ID of the parent container. If the parentId refers to a company, the new group is created under the 'Computers and Groups' group of that company. The user's company is automatically selected if no value is passed for this parameter.

Return value

This method returns a String: the ID of the new created group.

Example

Request:

  {
       "params": {
           "groupName": "myGroup",
           "parentId": "5582c0acb1a43d9f7f7b23c6"
       },
       "jsonrpc": "2.0",
       "method": "createCustomGroup",
       "id": "9600512e-4e89-438a-915d-1340c654ae34"
  }

Response:

  {
      "id": "9600512e-4e89-438a-915d-1340c654ae34",
      "jsonrpc":"2.0",
      "result": "5582c210b1a43d967f7b23c6"
  }
In this section: