---
title: "PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}"
method: PUT
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}"
tags: ["Apps"]
---

# PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}

`PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.IoTCentral/iotApps/{resourceName}`

Create or update the metadata of an IoT Central application. The usual pattern to modify a property is to retrieve the IoT Central application metadata and security metadata, and then combine them with the modified values in a new body to update the IoT Central application.

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `resourceName` string, required

## Query parameters

- `api-version` string, required

## Request body

- App — The common properties of an ARM resource.
  - `id` string — The ARM resource identifier.
  - `name` string — The ARM resource name.
  - `type` string — The resource type.
  - `location` string, required — The resource location.
  - `tags` object — The resource tags.

## Response `200`

This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.

- App — The common properties of an ARM resource.
  - `id` string — The ARM resource identifier.
  - `name` string — The ARM resource name.
  - `type` string — The resource type.
  - `location` string, required — The resource location.
  - `tags` object — The resource tags.

## Other responses

- `201` — This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.
- `202` — Accepted - Put request accepted; the operation will complete asynchronously.
- `default` — DefaultErrorResponse

---

[API](https://skmtc.net/azure/apis/iotcentralclient.md) · [All operations](https://skmtc.net/azure/apis/iotcentralclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iotcentralclient/versions/8bf783daad13/schema)