POST groups/{parentGroupId}/subgroups

Creates a new subgroup as a child of another group.

Remarks

C4M Error Code returned:

null
The subgroup has been created successfully.
ParentGroupNotFound
The subgroup could not be created because no parent group has been found with the specified .
MaximumGroupHierarchyNestingReached
The subgroup could not be created because the specified parent group is already at the maximum nesting level allowed.
GroupMustBeUnique
The subgroup could not be created because there is another group in the same group hierarchy level with the specified name.

HTTP Status returned:

403 - Forbidden
The authenticated user doesn't have permission to access the resource.

Request Information

Parameters

Name	Description	Additional information
parentGroupId	The identifier of the group that will be the container of the created group.	Define this parameter in the request URI.
requestDto	The group to create.	Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:

{
  "name": "Developers"
}

Response Information

The newly created group.

Response body formats

application/json, text/json

Sample:

{
  "enrollCode": "sample string 1",
  "fullName": "sample string 2",
  "id": 3,
  "name": "sample string 4",
  "parentFullName": "sample string 5",
  "parentGroupId": 1
}

Sample:

{
  "devices": [
    {
      "activeApplicationId": 1,
      "alias": "MyDevice",
      "creationDate": "2020-05-15T17:03:27.6960553-03:00",
      "enabled": true,
      "groupId": 1,
      "hardwareId": "0123456789012345",
      "id": 3,
      "lastCommunication": "2020-05-15T17:03:27.6960553-03:00",
      "lastGroupChangeDate": "2020-05-15T17:03:27.6960553-03:00",
      "lockPassword": "sample string 4",
      "platform": 0
    },
    {
      "activeApplicationId": 1,
      "alias": "MyDevice",
      "creationDate": "2020-05-15T17:03:27.6960553-03:00",
      "enabled": true,
      "groupId": 1,
      "hardwareId": "0123456789012345",
      "id": 3,
      "lastCommunication": "2020-05-15T17:03:27.6960553-03:00",
      "lastGroupChangeDate": "2020-05-15T17:03:27.6960553-03:00",
      "lockPassword": "sample string 4",
      "platform": 0
    }
  ],
  "profiles": [
    {
      "composedProfileType": 0,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 11,
      "certificateSettings": {
        "certificateAuthorities": null,
        "certificateIdentities": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 10,
      "telephonySettings": {
        "accessPointNames": null,
        "defaultAccessPointName": null,
        "incomingCallWhitelist": null,
        "outgoingCallWhitelist": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 12,
      "wifiSettings": {
        "wifiNetworks": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 9,
      "settings": {
        "applications": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 3,
      "blacklist": {
        "applications": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 8,
      "settings": {
        "applications": null,
        "downloadMethod": 0
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 7,
      "settings": {
        "maximumFailedPasswordAttemptsForWipe": 0,
        "passwordExpirationTimeout": 0,
        "passwordHistoryLength": 0,
        "passwordMinimumLength": 0,
        "passwordMinimumLetters": 0,
        "passwordMinimumLowercase": 0,
        "passwordMinimumNonLetter": 0,
        "passwordMinimumNumeric": 0,
        "passwordMinimumSymbols": 0,
        "passwordMinimumUppercase": 0,
        "passwordQuality": 0
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 6,
      "policy": {
        "addUser": false,
        "adjustMasterVolume": false,
        "alwaysOnVpnPackage": null,
        "applicationAutoUpdatePolicy": 0,
        "autoTime": false,
        "bluetooth": false,
        "bluetoothConfiguration": false,
        "bluetoothContactSharing": false,
        "camera": false,
        "cellBroadcastsConfiguration": false,
        "credentialsConfiguration": false,
        "dataRoaming": false,
        "debuggingFeatures": false,
        "ensureVerifyApplications": false,
        "factoryReset": false,
        "forceHighAccuracy": false,
        "frpAdminEmails": null,
        "installApplications": false,
        "keyguardFeatures": null,
        "locationMode": 0,
        "lockScreenInfo": null,
        "maximumTimeToLock": 0,
        "microphone": false,
        "mobileNetworksConfiguration": false,
        "modifyAccounts": false,
        "mountPhysicalMedia": false,
        "networkReset": false,
        "outgoingBeam": false,
        "outgoingCalls": false,
        "permissionPolicy": 0,
        "permittedInputMethods": null,
        "playStoreMode": 0,
        "removeUser": false,
        "safeMode": false,
        "screenCapture": false,
        "sendReceiveSms": false,
        "skipFirstUseHints": false,
        "stayOnPluggedModes": null,
        "systemUpdatePolicy": 0,
        "tetheringConfiguration": false,
        "uninstallApplications": false,
        "untrustedApplicationsPolicy": 0,
        "usbFileTransfer": false,
        "vpnConfiguration": false,
        "wifiConfiguration": false,
        "windowedUpdateEndTime": 0,
        "windowedUpdateStartTime": 0
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 4,
      "launcherSettings": {
        "blockStatusBar": false,
        "enabled": false,
        "horizontalBackgroundImage": null,
        "lockTaskAllowed": false,
        "password": null,
        "passwordType": 0,
        "titleText": null,
        "verticalBackgroundImage": null,
        "whitelist": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 5,
      "policy": {
        "airplaneMode": false,
        "bluetooth": false,
        "camera": false,
        "clipboard": false,
        "factoryReset": false,
        "homeKey": false,
        "microphone": false,
        "nfc": false,
        "powerOff": false,
        "safeMode": false,
        "screenCapture": false,
        "settingsChanges": false,
        "statusBarExpansion": false,
        "taskManager": false,
        "wifi": false
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "applicationSettings": {
        "applications": null
      },
      "composedProfileType": 2,
      "policy": {
        "airplaneMode": false,
        "audioRecord": false,
        "bluetooth": false,
        "camera": false,
        "clipboard": false,
        "clipboardShare": false,
        "factoryReset": false,
        "headphone": false,
        "homeKey": false,
        "microphone": false,
        "navigationBar": false,
        "nfc": false,
        "otaUpgrade": false,
        "powerOff": false,
        "safeMode": false,
        "screenCapture": false,
        "settingsChanges": false,
        "softwareInstallation": false,
        "softwareUninstallation": false,
        "statusBar": false,
        "statusBarExpansion": false,
        "sVoice": false,
        "taskManager": false,
        "videoRecord": false,
        "wifi": false
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "applicationUsage": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "battery": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "composedProfileType": 0,
      "dataUsage": {
        "beginOfCycle": null,
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "location": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "locationHistory": {
        "monitoringQuality": null,
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "memory": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    }
  ],
  "subgroups": [
    {
      "devices": null,
      "profiles": null,
      "subgroups": null,
      "enrollCode": "sample string 1",
      "fullName": "sample string 2",
      "id": 3,
      "name": "sample string 4",
      "parentFullName": "sample string 5",
      "parentGroupId": 1
    },
    {
      "devices": null,
      "profiles": null,
      "subgroups": null,
      "enrollCode": "sample string 1",
      "fullName": "sample string 2",
      "id": 3,
      "name": "sample string 4",
      "parentFullName": "sample string 5",
      "parentGroupId": 1
    }
  ],
  "enrollCode": "sample string 1",
  "fullName": "sample string 2",
  "id": 3,
  "name": "sample string 4",
  "parentFullName": "sample string 5",
  "parentGroupId": 1
}