---
title: "POST /deviceUpdate/{instanceId}/updates:import"
method: POST
path: "/deviceUpdate/{instanceId}/updates:import"
tags: ["Update management"]
---

# POST /deviceUpdate/{instanceId}/updates:import

`POST /deviceUpdate/{instanceId}/updates:import`

Import new update version. This is a long-running-operation; use Operation-Location response header value to check for operation status.

## Path parameters

- `instanceId` string, required

## Query parameters

- `api-version` string, required

## Request body

- ImportUpdateInputItem[] — Import update input metadata.
  - `importManifest` ImportManifestMetadata, required — Metadata describing the import manifest, a document which describes the files and other metadata about an update version.
    - `url` string, required — Azure Blob location from which the import manifest can be downloaded by Device Update for IoT Hub. This is typically a read-only SAS-protected blob URL with an expiration set to at least 4 hours.
    - `sizeInBytes` integer, required — File size in number of bytes.
    - `hashes` object, required — A JSON object containing the hash(es) of the file. At least SHA256 hash is required. This object can be thought of as a set of key-value pairs where the key is the hash algorithm, and the value is the hash of the file calculated using that algorithm.
  - `friendlyName` string — Friendly update name.
  - `files` FileImportMetadata[] — One or more update file properties like filename and source URL.
    - `filename` string, required — Update file name as specified inside import manifest.
    - `url` string, required — Azure Blob location from which the update file can be downloaded by Device Update for IoT Hub. This is typically a read-only SAS-protected blob URL with an expiration set to at least 4 hours.

## Response `202`

Accepted update import request; background operation location to track status is specified in Operation-Location response header.

## Other responses

- `default` — Default response.

## Changes

- **2026-07-13** (2020-09-01) `5ba53cf1b884` — 1 info
  - endpoint added
- **2026-07-13** (2020-09-01) `6f894985f81d` — 1 info
  - added the success response with the status `200`
- **2021-03-02** (2020-09-01) `be0eed01a5b1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/deviceupdate-microsoft-deviceupdate/changes/deviceUpdate/:instanceId/updates:import/post.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/5ba53cf1b884/schema)