---
title: "POST /data-services"
method: POST
path: "/data-services"
tags: ["Data Services"]
---

# POST /data-services

`POST /data-services`

Creates a data service resource.
The path to the newly created resource will be returned in the *Location* response header.

## Request body

- DataService — Data Marketplace Metadata schema for a Dataservice
  - `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 extension, 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
  - `apiType` 'REST' | 'SOAP' | 'Event' | 'RPC' | 'GraphQL' — The API type.
  - `endpointDescription` string, required — A concise narrative of the content of end point service.
  - `endpointURL` string — A concise narrative of the content of end point service.
  - `servesDataset` string[] — A collection of datasets, or the references to the datasets, that this data service can distribute.
  - `serviceType` 'Bulk' | 'Transactional' | 'Information' — The Service type.

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `409` — Conflict

---

[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)