---
title: "Updates the device."
method: PUT
path: "/api/edge/devices"
tags: ["IoT Edge Devices"]
---

# Updates the device.

`PUT /api/edge/devices`

## Request body

- IoTEdgeDevice — IoT Edge device.
  - `deviceId` string, nullable — The IoT Edge identifier.
  - `deviceName` string, required — The name of the device.
  - `modelId` string, required — The model identifier.
  - `imageUrl` string, uri, nullable — The device model image Url.
  - `connectionState` string, nullable — The IoT Edge connection state.
  - `scope` string, nullable — The IoT Edge scope tag value.
  - `status` string, nullable — The IoT Edge device status.
  - `runtimeResponse` string, nullable — The IoT Edge runtime response.
  - `nbDevices` integer — The number of connected devices on IoT Edge device.
  - `nbModules` integer — The number of modules on IoT Edge device.
  - `lastDeployment` ConfigItem — IoT Edge configuration
    - `name` string, required — The IoT Edge configuration name.
    - `dateCreation` string, date-time — The IoT Edge configuration creation date.
    - `status` string, nullable — The IoT Edge configuration status.
  - `modules` IoTEdgeModule[], nullable — The IoT Edge modules.
    - `id` string, nullable — The module name, only used for AWS IoT Greengrass.
    - `moduleName` string, required — The module name.
    - `imageURI` string, required — the device image URI.
    - `containerCreateOptions` string, nullable
    - `status` string, nullable — The module status.
    - `environmentVariables` IoTEdgeModuleEnvironmentVariable[], nullable — The module environment variables.
      - `name` string, nullable — The module environment variable name
      - `value` string, nullable — The module environment variable value
    - `moduleIdentityTwinSettings` IoTEdgeModuleTwinSetting[], nullable — The module identity twin settings.
      - `name` string, nullable — The module identity twin setting name
      - `value` string, nullable — The module identity twin setting value
    - `commands` IoTEdgeModuleCommand[], nullable — The module commands.
      - `name` string, nullable — The command name
      - `edgeDeviceModelId` string, nullable
      - `commandId` string, nullable
      - `moduleName` string, nullable
    - `version` string, nullable
  - `tags` object, nullable — List of custom device tags and their values.
  - `isEnabled` boolean — `true` if this instance is enabled; otherwise, `false`.
  - `labels` LabelDto[], nullable — Labels
    - `name` string, required
    - `color` string, required

## Response `200`

Success

---

[API](https://skmtc.net/cgi-fr/apis/azure-iot-hub-portal-api.md) · [All operations](https://skmtc.net/cgi-fr/apis/azure-iot-hub-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cgi-fr/azure-iot-hub-portal-api/versions/ce058568b9f0/schema)