---
title: "PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}"
method: PATCH
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}"
tags: ["VirtualMachineImageTemplate"]
---

# PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}

`PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VirtualMachineImages/imageTemplates/{imageTemplateName}`

Update the tags for this Virtual Machine Image Template

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `imageTemplateName` string, required

## Query parameters

- `api-version` string, required

## Request body

- ImageTemplateUpdateParameters — Parameters for updating an image template.
  - `identity` ImageTemplateIdentity — Identity for the image template.
    - `type` 'UserAssigned' | 'None' — The type of identity used for the image template. The type 'None' will remove any identities from the image template.
    - `userAssignedIdentities` UserAssignedIdentities — The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
  - `tags` object — The user-specified tags associated with the image template.
  - `properties` object — Parameters for updating an image template.
    - `distribute` ImageTemplateDistributor[] — The distribution targets where the image output needs to go to.
      - `type` string, required — Type of distribution.
      - `runOutputName` string, required — The name to be used for the associated RunOutput.
      - `artifactTags` object — Tags that will be applied to the artifact once it has been created/updated by the distributor.

## Response `200`

OK

- ImageTemplate — unresolved $ref

## Other responses

- `202` — The operation will be completed asynchronously.
- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2018-02-01-preview) `fdab4083973e` — 3 warning
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2018-02-01-preview) `e595c96bf631` — 1 info
  - added the success response with the status `202`
- **2026-07-13** (2018-02-01-preview) `7e3d56a97f31` — 1 info
  - api operation id `VirtualMachineImageTemplate_Update` removed and replaced with `VirtualMachineImageTemplates_Update`

[Change history](https://skmtc.dev/azure/apis/imagebuilder-microsoft-virtualmachineimages-imagebuilder/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.VirtualMachineImages/imageTemplates/:imageTemplateName/patch.md)

---

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