---
title: "POST /manifest"
method: POST
path: "/manifest"
---

# POST /manifest

`POST /manifest`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- Manifest
  - `metadata_file` string, required: The name of the associated metadata file. The metadata file is assumed to be in the zip alongside the manifest file. Currently only JSON format is accepted. The file name must have a `.json` extension and can only contain letters, numbers, underscores (`_`) and hyphens (`-`). Keeping the metadata file separate allows for better decoupling between the manifest and metadata file. This could be beneficial as we iterate towards the "Common Interchange Format", where the metadata file would be a standard across the organisation for sharing statistical outputs between systems and may therefore not have the additional pipeline specific files the manifest currently provides. An alternative approach could be to combine the two files.
  - `submission_contacts` Submitter[], required: The list of individuals who submitted the dataset. This is the list of individuals to that will receive processing and failure notifications for the dataset import.
    - `email` string, email, required: The email of the individual to notify.

## Changes

- **2025-03-20** `aec576172a51`: 1 breaking
  - added the pattern `@(ext\.)?ons\.gov\.uk$` to the request property `submission_contacts/items/email`
- **2025-03-12** `f7b5a3b0605c`: 2 breaking, 1 warning
  - added the new required request property `submission_contacts`
  - added the pattern `^[0-9a-zA-Z_-]+.json$` to the request property `metadata_file`
  - removed the request property `submitter`
- **2025-03-12** `52867e71d0a3`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/office-of-national-statistics/apis/dataset-metadata-manifest-schema-definitions.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/dataset-metadata-manifest-schema-definitions/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/dataset-metadata-manifest-schema-definitions/revisions/f7dad130aed8?raw)