---
title: "Changes to POST /metadata"
method: POST
path: "/metadata"
---

# Changes to POST /metadata

`POST /metadata`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 6 revisions.

- **2025-04-25** `f7dad130aed8`: 1 breaking
- **2025-04-03** `b37528408dd6`: 1 breaking
- **2025-03-20** `aec576172a51`: 7 breaking, 1 info
- **2025-03-12** `f7b5a3b0605c`: 3 breaking, 4 warning, 3 info
- **2025-03-12** `52867e71d0a3`: 1 info

## Changes

- **2025-04-25** `f7dad130aed8`: 1 breaking
  - added the new required request property `release_date`
- **2025-04-03** `b37528408dd6`: 1 breaking
  - the request property `edition_title` became required
- **2025-03-20** `aec576172a51`: 7 breaking, 1 info
  - the `alerts/items/description` request property's minLength was increased from `0` to `1`
  - the `dataset_id` request property's minLength was increased from `0` to `1`
  - the `distributions` request property's minLength was increased from `0` to `1`
  - the `distributions/items/title` request property's minLength was increased from `0` to `1`
  - the `edition` request property's minLength was increased from `0` to `1`
  - the `usage_notes/items/note` request property's minLength was increased from `0` to `1`
  - the `usage_notes/items/title` request property's minLength was increased from `0` to `1`
  - added the new optional request property `edition_title`
- **2025-03-12** `f7b5a3b0605c`: 3 breaking, 4 warning, 3 info
  - added the new required request property `distributions/items/file`
  - added the pattern `^[a-z0-9]+(-[a-z0-9]+)*$` to the request property `dataset_id`
  - added the pattern `^[a-z0-9]+(-[a-z0-9]+)*$` to the request property `edition`
  - the `dataset_id` request property's maxLength was set to `100`
  - the `edition` request property's maxLength was set to `100`
  - removed the request property `distributions/items/download_url`
  - removed the request property `quality_desigination`
  - added the new optional request property `quality_designation`
  - the request property `alerts` became optional
  - the request property `usage_notes` became optional
- **2025-03-12** `52867e71d0a3`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/office-of-national-statistics/apis/dataset-metadata-manifest-schema-definitions/docs/metadata/post.md) - [API](https://skmtc.dev/office-of-national-statistics/apis/dataset-metadata-manifest-schema-definitions.md) - [Page](https://skmtc.dev/office-of-national-statistics/apis/dataset-metadata-manifest-schema-definitions/changes/metadata/post)