---
title: "PUT /digitaltwins/{id}"
method: PUT
path: "/digitaltwins/{id}"
tags: ["Twins"]
---

# PUT /digitaltwins/{id}

`PUT /digitaltwins/{id}`

Adds or replaces a digital twin.
Status codes:
* 200 OK
* 400 Bad Request
  * InvalidArgument - The digital twin id or payload is invalid.
  * ModelDecommissioned - The model for the digital twin is decommissioned.
  * TwinLimitReached - The maximum number of digital twins allowed has been reached.
  * ValidationFailed - The digital twin payload is not valid.
* 412 Precondition Failed
  * PreconditionFailed - The precondition check (If-Match or If-None-Match) failed.

## Path parameters

- `id` string, required

## Query parameters

- `api-version` string, required

## Headers

- `If-None-Match` '*'

## Request body

- object

## Response `200`

Success

- DigitalTwin — Digital twin

## 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/versions/8d81dcdaf9a2/schema)