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

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

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 56 revisions.

- **2023-11-01** `60a3b73ce5bb`: 1 breaking
- **2023-11-01** `2ed3837ebf06`: 1 info
- **2023-11-01** `a7203e98e6a5`: 1 breaking, 1 info

## Changes

- **2023-11-01** `60a3b73ce5bb`: 1 breaking
  - the `{fieldName}` request property type changed from no type to `string`
- **2023-11-01** `2ed3837ebf06`: 1 info
  - added the new optional request property `{fieldName}`
- **2023-11-01** `a7203e98e6a5`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `204`

---

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