---
title: "Changes to Create document with custom ID or update entire document"
method: PUT
path: "/api/dataentities/{dataEntityName}/documents/{id}"
---

# Changes to Create document with custom ID or update entire document

`PUT /api/dataentities/{dataEntityName}/documents/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 62 revisions.

- **2026-01-26** `c22f3bc5df7b`: 2 breaking, 2 info
- **2023-10-19** `ec855fcbf2c8`: 4 info

## Changes

- **2026-01-26** `c22f3bc5df7b`: 2 breaking, 2 info
  - removed the success response with the status `200`
  - removed the success response with the status `201`
  - removed the non-success response with the status `304`
  - added the success response with the status `204`
- **2023-10-19** `ec855fcbf2c8`: 4 info
  - added the non-success response with the status `304`
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - added the success response with the status `201`

---

[Operation](https://skmtc.dev/vtex/apis/master-data-api-v2/docs/api/dataentities/:dataEntityName/documents/:id/put.md) - [API](https://skmtc.dev/vtex/apis/master-data-api-v2.md) - [Page](https://skmtc.dev/vtex/apis/master-data-api-v2/changes/api/dataentities/:dataEntityName/documents/:id/put)