---
title: "PUT /deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}"
method: PUT
path: "/deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}"
tags: ["Deployment management"]
---

# PUT /deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}

`PUT /deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}`

Creates or updates a deployment.

## Path parameters

- `instanceId` string, required
- `deploymentId` string, required

## Request body

- Deployment — Deployment metadata.
  - `deploymentId` string, required — Gets or sets the deployment identifier.
  - `deploymentType` 'Complete' | 'Download' | 'Install', required — Supported deployment types.
  - `deviceClassId` string — Gets or sets the device class identifier.
  - `startDateTime` string, date-time, required — Gets or sets the Deployment start datetime.
  - `deviceGroupType` 'All' | 'Devices' | 'DeviceGroupDefinitions', required — Supported deployment group types.
  - `deviceGroupDefinition` string[], required — Gets or sets the device group definition.
  - `updateId` UpdateId, required — Update identifier.
    - `provider` string, required — Update provider.
    - `name` string, required — Update name.
    - `version` string, required — Update version.
  - `isCanceled` boolean — Boolean flag indicating whether the deployment was canceled.
  - `isRetried` boolean — Boolean flag indicating whether the deployment has been retried.
  - `isCompleted` boolean — Boolean flag indicating whether the deployment was completed.

## Response `200`

The deployment properties.

- Deployment — Deployment metadata.
  - `deploymentId` string, required — Gets or sets the deployment identifier.
  - `deploymentType` 'Complete' | 'Download' | 'Install', required — Supported deployment types.
  - `deviceClassId` string — Gets or sets the device class identifier.
  - `startDateTime` string, date-time, required — Gets or sets the Deployment start datetime.
  - `deviceGroupType` 'All' | 'Devices' | 'DeviceGroupDefinitions', required — Supported deployment group types.
  - `deviceGroupDefinition` string[], required — Gets or sets the device group definition.
  - `updateId` UpdateId, required — Update identifier.
    - `provider` string, required — Update provider.
    - `name` string, required — Update name.
    - `version` string, required — Update version.
  - `isCanceled` boolean — Boolean flag indicating whether the deployment was canceled.
  - `isRetried` boolean — Boolean flag indicating whether the deployment has been retried.
  - `isCompleted` boolean — Boolean flag indicating whether the deployment was completed.

## Other responses

- `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/deployments/:deploymentId/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)