---
title: "Post Collection Exercise End Message"
method: POST
path: "/collection-exercise-end"
deprecated: true
---

# Post Collection Exercise End Message

`POST /collection-exercise-end`

## Request

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

> **Deprecated.**

Endpoint to receive collection exercise end message, process the message and mark datasets for deletion
if dataset_guid is present in the message.

Parameters:
collection_end_data (CollectionExerciseEndData): The collection exercise end message body, containing the GUID
of the dataset to be deleted and the survey_id and period id to find the relevant dataset metadata for deletion.

This endpoint is currently not being used and is partially built without implementation of unhappy path

## Request body

- CollectionExerciseEndData
  - `survey_id` string, required
  - `period_id` string, required
  - `dataset_guid` string, nullable

## Response `200`

Successful Response

- unknown

## Changes

> 32 revisions in range; 2 not diffed.

- **2026-07-01** `9a87e51baf13`: 1 info
  - endpoint deprecated
- **2026-03-31** `2ebb9ce5ecea`: 1 info
  - the request property `dataset_guid` became optional
- **2025-10-16** `9c1da8e290fb`: 1 breaking, 1 info
  - the request property `dataset_guid` became required
  - the `dataset_guid` request property default value `` was removed
- **2024-12-05** `0b183cf4153b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/changes/collection-exercise-end/post.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/revisions/9a87e51baf13?raw)