PUT groups/{groupId}

Updates a root group.

Remarks

C4M Error Code returned:

null
The group has been updated successfully.
GroupNotFound
The group wasn't found.

HTTP Status returned:

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

Request Information

Parameters

Name	Description	Additional information
groupId	The groupId from the group to update.	Define this parameter in the request URI.
requestedGroup	The group to update.	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
}