---
title: "Changes to Create new document"
method: POST
path: "/api/dataentities/{acronym}/documents"
---

# Changes to Create new document

`POST /api/dataentities/{acronym}/documents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 56 revisions.

- **2026-01-26** `4e05d3dd9e3c`: 3 warning, 3 info
- **2023-11-01** `60a3b73ce5bb`: 1 breaking
- **2023-11-01** `2ed3837ebf06`: 1 info
- **2023-11-01** `a7203e98e6a5`: 1 breaking, 1 info

## Changes

- **2026-01-26** `4e05d3dd9e3c`: 3 warning, 3 info
  - removed the optional property `DocumentId` from the response with the `201` status
  - removed the optional property `Href` from the response with the `201` status
  - removed the optional property `Id` from the response with the `201` status
  - added the optional property `documentId` to the response with the `201` status
  - added the optional property `href` to the response with the `201` status
  - added the optional property `id` to the response with the `201` status
- **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 `201`

---

[Operation](https://skmtc.dev/vtex/apis/master-data-api-v1/docs/api/dataentities/:acronym/documents/post.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/post)