---
title: "PUT /jobs/imports/{id}"
method: PUT
path: "/jobs/imports/{id}"
tags: ["Jobs"]
---

# PUT /jobs/imports/{id}

`PUT /jobs/imports/{id}`

Creates an import job.
Status codes:
* 201 Created
* 400 Bad Request
  * JobLimitReached - The maximum number of import jobs allowed has been reached.
  * ValidationFailed - The import job request is not valid.

## Path parameters

- `id` string, required

## Query parameters

- `api-version` string, required

## Request body

- ImportJob — A job which contains a reference to the operations to perform, results, and execution metadata.
  - `id` string — The identifier of the import job.
  - `inputBlobUri` string, required — The path to the input Azure storage blob that contains file(s) describing the operations to perform in the job.
  - `outputBlobUri` string, required — The path to the output Azure storage blob that will contain the errors and progress logs of import job.
  - `status` 'notstarted' | 'running' | 'failed' | 'succeeded' | 'cancelling' | 'cancelled' — Status of the job.
  - `createdDateTime` string, date-time — Start time of the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `lastActionDateTime` string, date-time — Last time service performed any action from the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `finishedDateTime` string, date-time — End time of the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `purgeDateTime` string, date-time — Time at which job will be purged by the service from the system. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `error` Error — Error definition.
    - `code` string — Service specific error code which serves as the substatus for the HTTP error code.
    - `message` string — A human-readable representation of the error.
    - `details` Error[] — Internal error details.
    - `innererror` InnerError — A more specific error description than was provided by the containing error.
      - `code` string — A more specific error code than was provided by the containing error.
      - `innererror` InnerError — recursive

## Response `201`

Success

- ImportJob — A job which contains a reference to the operations to perform, results, and execution metadata.
  - `id` string — The identifier of the import job.
  - `inputBlobUri` string, required — The path to the input Azure storage blob that contains file(s) describing the operations to perform in the job.
  - `outputBlobUri` string, required — The path to the output Azure storage blob that will contain the errors and progress logs of import job.
  - `status` 'notstarted' | 'running' | 'failed' | 'succeeded' | 'cancelling' | 'cancelled' — Status of the job.
  - `createdDateTime` string, date-time — Start time of the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `lastActionDateTime` string, date-time — Last time service performed any action from the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `finishedDateTime` string, date-time — End time of the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `purgeDateTime` string, date-time — Time at which job will be purged by the service from the system. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
  - `error` Error — Error definition.
    - `code` string — Service specific error code which serves as the substatus for the HTTP error code.
    - `message` string — A human-readable representation of the error.
    - `details` Error[] — Internal error details.
    - `innererror` InnerError — A more specific error description than was provided by the containing error.
      - `code` string — A more specific error code than was provided by the containing error.
      - `innererror` InnerError — recursive

## Other responses

- `default` — Default response.

---

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