---
title: "PATCH /datasets/{dataset-id}"
method: PATCH
path: "/datasets/{dataset-id}"
tags: ["Datasets"]
---

# PATCH /datasets/{dataset-id}

`PATCH /datasets/{dataset-id}`

Updates a dataset resource by identifier. 

Implements JSON Merge Patch [https://www.rfc-editor.org/rfc/rfc7396](https://www.rfc-editor.org/rfc/rfc7396)

## Path parameters

- `dataset-id` string, uuid, required

## Request body

- DatasetJsonMergePatchModel — Json Merge Patch schema definition for a Data Marketplace Metadata schema for a Dataset
  - `accessRights` 'INTERNAL' | 'OPEN' | 'COMMERCIAL' — A rights statement that concerns how the distribution is accessed.
  - `contactPoint` object[] — Contact information
    - `name` string, required
    - `email` string, required
    - `role` 'owner' | 'contact'
  - `description` string — A concise narrative of the content of a *cataloged-resource*.
  - `identifier` string — A unique number, code, or reference value assigned to a *cataloged-resource* within the catalogue.
  - `keyword` string[] — Uncontrolled terms (words or phrases) assigned to describe an information resource.
  - `modified` union
    - string — Date in format YYYY-MM-DD.
    - string, date-time
  - `publisher` string — The entity responsible for making the *cataloged-resource* available in the catalogue.
  - `securityClassification` 'OFFICIAL' | 'SECRET' | 'TOP_SECRET' | 'NOT_APPLICABLE' — An information security designation that identifies the minimum level of protection assigned to an information resource.
  - `status` 'Draft' | 'Published' | 'Withdrawn' | 'Deleted' — Lifecycle status of a *cataloged-resource* within the catalogue.
  - `supplierIdentifier` string — A unique number, code, or reference value assigned to a *cataloged-resource* in a third party (supplier's) system.
  - `theme` string[] — Topic: A controlled term that expresses the broad topical content of an information resource. Subject: A controlled term that expresses a topic of the intellectual content of an information resource.
  - `title` string — The full and formal name given to an information resource. A name given to the distribution.
  - `type` 'Data Set' | 'Data Service' | 'Data Group' | 'Data Share' — Topic: A controlled term that expresses the broad topical content of an information resource. Subject: A controlled term that expresses a topic of the intellectual content of an information resource.
  - `distribution` object[] — A collection of distributions
    - `accessService` string[] — A reference to the service that provided the data
    - `downloadURL` string — The location from which the Dataset can be downloaded
    - `mediaType` string[] — The IANA media type, or file format, type, or extention, of the distribution file.
  - `issued` union
    - string — Date in format YYYY-MM-DD.
    - string, date-time
  - `updateFrequency` string — The schedule for how often the data is updated

## Response `200`

Success

- Dataset — Data Marketplace Metadata schema for a Dataset
  - `accessRights` 'INTERNAL' | 'OPEN' | 'COMMERCIAL' — A rights statement that concerns how the distribution is accessed.
  - `contactPoint` object[], required — Contact information
    - `name` string, required
    - `email` string, required
    - `role` 'owner' | 'contact'
  - `description` string, required — A concise narrative of the content of a *cataloged-resource*.
  - `identifier` string — A unique number, code, or reference value assigned to a *cataloged-resource* within the catalogue.
  - `keyword` string[] — Uncontrolled terms (words or phrases) assigned to describe an information resource.
  - `modified` union
    - string — Date in format YYYY-MM-DD.
    - string, date-time
  - `publisher` string — The entity responsible for making the *cataloged-resource* available in the catalogue.
  - `securityClassification` 'OFFICIAL' | 'SECRET' | 'TOP_SECRET' | 'NOT_APPLICABLE' — An information security designation that identifies the minimum level of protection assigned to an information resource.
  - `status` 'Draft' | 'Published' | 'Withdrawn' | 'Deleted' — Lifecycle status of a *cataloged-resource* within the catalogue.
  - `supplierIdentifier` string — A unique number, code, or reference value assigned to a *cataloged-resource* in a third party (supplier's) system.
  - `theme` string[] — Topic: A controlled term that expresses the broad topical content of an information resource. Subject: A controlled term that expresses a topic of the intellectual content of an information resource.
  - `title` string, required — The full and formal name given to an information resource. A name given to the distribution.
  - `type` 'Data Set' | 'Data Service' | 'Data Group' | 'Data Share', required — Topic: A controlled term that expresses the broad topical content of an information resource. Subject: A controlled term that expresses a topic of the intellectual content of an information resource.
  - `distribution` object[] — A collection of distributions
    - `accessService` string[] — A reference to the service that provided the data
    - `downloadURL` string — The location from which the Dataset can be downloaded
    - `mediaType` string[] — The IANA media type, or file format, type, or extention, of the distribution file.
  - `issued` union
    - string — Date in format YYYY-MM-DD.
    - string, date-time
  - `updateFrequency` string — The schedule for how often the data is updated

## Other responses

- `400` — A 400 Bad Request response status is returned for validation or other business errors.
- `404` — Resource does not exist.

---

[API](https://skmtc.dev/central-digital-and-data-office/apis/data-catalogue-metadata-api.md) · [All operations](https://skmtc.dev/central-digital-and-data-office/apis/data-catalogue-metadata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/central-digital-and-data-office/data-catalogue-metadata-api/revisions/af79e2f715dc/schema)