---
title: "Changes to Create DocumentReference"
method: POST
path: "/main/DocumentReference"
---

# Changes to Create DocumentReference

`POST /main/DocumentReference`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `1a14a579daec`: 8 breaking, 26 warning, 45 info

## Changes

- **2026-11-03** `1a14a579daec`: 8 breaking, 26 warning, 45 info
  - added the new required request property `author/items/reference` (media type: application/fhir+json)
  - added the new required request property `subject/reference` (media type: application/fhir+json)
  - the `author/items/` request property type changed from no type to `object` (media type: application/fhir+json)
  - the `content/items/attachment` request property type changed from no type to `object` (media type: application/fhir+json)
  - the `subject` request property type changed from no type to `object` (media type: application/fhir+json)
  - the `author/items/` response's property type changed from no type to `object` for status `201` (media type: application/fhir+json)
  - the `content/items/attachment` response's property type changed from no type to `object` for status `201` (media type: application/fhir+json)
  - the `subject` response's property type changed from no type to `object` for status `201` (media type: application/fhir+json)
  - removed `#/components/schemas/FhirAttachment.jsonfhir` from the `content/items/attachment` request property `allOf` list (media type: application/fhir+json)
  - removed `#/components/schemas/FhirReference.jsonfhir` from the `author/items/` request property `allOf` list (media type: application/fhir+json)
  - removed `#/components/schemas/FhirReference.jsonfhir` from the `subject` request property `allOf` list (media type: application/fhir+json)
  - removed the request property `contained/items/meta` (media type: application/fhir+json)
  - removed the request property `contained/items/meta` (media type: application/json)
  - removed the request property `contained/items/resourceType` (media type: application/fhir+json)
  - removed the request property `contained/items/resourceType` (media type: application/json)
  - removed the optional property `contained/items/id` from the response with the `201` status (media type: application/fhir+json)
  - removed the optional property `contained/items/id` from the response with the `201` status (media type: application/json)
  - removed the optional property `contained/items/meta` from the response with the `201` status (media type: application/fhir+json)
  - removed the optional property `contained/items/meta` from the response with the `201` status (media type: application/json)
  - removed the optional property `contained/items/resourceType` from the response with the `201` status (media type: application/fhir+json)
  - removed the optional property `contained/items/resourceType` from the response with the `201` status (media type: application/json)
  - added the new `ValueSet` enum value to the `author/items/type` response property for the response status `201` (media type: application/json)
  - added the new `ValueSet` enum value to the `custodian/type` response property for the response status `201` (media type: application/fhir+json)
  - added the new `ValueSet` enum value to the `custodian/type` response property for the response status `201` (media type: application/json)
  - added the new `ValueSet` enum value to the `masterIdentifier/anyOf[#/components/schemas/FhirIdentifier.jsonfhir]/assigner/anyOf[#/components/schemas/FhirReference.jsonfhir]/type` response property for the response status `201` (media type: application/fhir+json)
  - added the new `ValueSet` enum value to the `masterIdentifier/anyOf[#/components/schemas/FhirIdentifier]/assigner/anyOf[#/components/schemas/FhirReference]/type` response property for the response status `201` (media type: application/json)
  - added the new `ValueSet` enum value to the `subject/type` response property for the response status `201` (media type: application/json)
  - added the new `ValueSetConcept` enum value to the `author/items/type` response property for the response status `201` (media type: application/json)
  - added the new `ValueSetConcept` enum value to the `custodian/type` response property for the response status `201` (media type: application/fhir+json)
  - added the new `ValueSetConcept` enum value to the `custodian/type` response property for the response status `201` (media type: application/json)
  - added the new `ValueSetConcept` enum value to the `masterIdentifier/anyOf[#/components/schemas/FhirIdentifier.jsonfhir]/assigner/anyOf[#/components/schemas/FhirReference.jsonfhir]/type` response property for the response status `201` (media type: application/fhir+json)
  - added the new `ValueSetConcept` enum value to the `masterIdentifier/anyOf[#/components/schemas/FhirIdentifier]/assigner/anyOf[#/components/schemas/FhirReference]/type` response property for the response status `201` (media type: application/json)
  - added the new `ValueSetConcept` enum value to the `subject/type` response property for the response status `201` (media type: application/json)
  - added the new `image/gif` enum value to the `content/items/attachment/contentType` response property for the response status `201` (media type: application/json)
  - added the new optional request property `author/items/type` (media type: application/fhir+json)
  - added the new optional request property `content/items/attachment/contentType` (media type: application/fhir+json)
  - added the new optional request property `content/items/attachment/creation` (media type: application/fhir+json)
  - added the new optional request property `content/items/attachment/data` (media type: application/fhir+json)
  - added the new optional request property `content/items/attachment/hash` (media type: application/fhir+json)
  - added the new optional request property `content/items/attachment/language` (media type: application/fhir+json)
  - …39 more

---

[Operation](https://skmtc.dev/halaxy/apis/halaxy-api/docs/main/DocumentReference/post.md) - [API](https://skmtc.dev/halaxy/apis/halaxy-api.md) - [Page](https://skmtc.dev/halaxy/apis/halaxy-api/changes/main/DocumentReference/post)