---
title: "PUT /deviceupdate/{instanceId}/v2/management/groups/{groupId}"
method: PUT
path: "/deviceupdate/{instanceId}/v2/management/groups/{groupId}"
tags: ["Device management"]
---

# PUT /deviceupdate/{instanceId}/v2/management/groups/{groupId}

`PUT /deviceupdate/{instanceId}/v2/management/groups/{groupId}`

Create or update a device group.

## Path parameters

- `instanceId` string, required
- `groupId` string, required

## Request body

- Group — Group details.
  - `groupId` string, required — Group identity.
  - `groupType` 'IoTHubTag', required — Supported group types.
  - `tags` string[], required — IoT Hub tags.
  - `createdDateTime` string, required — Date and time when the update was created.
  - `deviceCount` integer — The number of devices in the group.

## Response `200`

The group properties.

- Group — Group details.
  - `groupId` string, required — Group identity.
  - `groupType` 'IoTHubTag', required — Supported group types.
  - `tags` string[], required — IoT Hub tags.
  - `createdDateTime` string, required — Date and time when the update was created.
  - `deviceCount` integer — The number of devices in the group.

## Other responses

- `400` — GroupId in query parameter and request body don't match.
- `404` — Not found.

## Changes

- **2021-03-02** (2020-09-01) `be0eed01a5b1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/deviceupdate-microsoft-deviceupdate/changes/deviceupdate/:instanceId/v2/management/groups/:groupId/put.md)

---

[API](https://skmtc.dev/azure/apis/deviceupdate-microsoft-deviceupdate.md) · [All operations](https://skmtc.dev/azure/apis/deviceupdate-microsoft-deviceupdate/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/deviceupdate-microsoft-deviceupdate/revisions/be0eed01a5b1/schema)