---
title: "PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}"
method: PUT
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}"
tags: ["Labs"]
---

# PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}

`PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}`

Create or replace an existing lab. This operation can take a while to complete.

## Path parameters

- `name` string, required

## Parameters

- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v3/types.json#/components/parameters/ResourceGroupNameParameter` — unresolved $ref

## Request body

- Lab — unresolved $ref

## Response `200`

Resource 'Lab' update operation succeeded

- Lab — unresolved $ref

## Other responses

- `201` — Resource 'Lab' create operation succeeded
- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2015-05-21-preview) `a25ee04d4396` — 3 warning, 1 info
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
  - the endpoint scheme security `azure_auth` was removed from the API
- **2026-07-13** (2015-05-21-preview) `228c0007a018` — 5 info
  - api operation id `Lab_CreateOrUpdateResource` removed and replaced with `Labs_CreateOrUpdate`
  - the endpoint scheme security `azure_auth` was added to the API
  - the endpoint scheme security `oauth2` was removed from the API
  - api tag `Labs` added
  - …1 more

[Change history](https://skmtc.dev/azure/apis/devtestlabs-microsoft-devtestlab-devtestlabs/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.DevTestLab/labs/:name/put.md)

---

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