---
title: "Create"
method: POST
path: "/api/v1/retention-changes"
tags: ["retention-changes"]
---

# Create

`POST /api/v1/retention-changes`

## Headers

- `authorization` string, nullable — Bearer <token>

## Request body

- ChangeCreate
  - `note` string, required
  - `title` string
  - `kind` 'issue' | 'improvement' | 'experiment' | 'other'
  - `user_scope` 'unknown' | 'new_users' | 'all_users'
  - `audience` string
  - `start_kind` 'exact' | 'range' | 'unknown'
  - `start_date` string, date, nullable
  - `start_latest` string, date, nullable
  - `end_kind` 'ongoing' | 'ended' | 'unknown'
  - `end_date` string, date, nullable
  - `id` string, uuid, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-25** `93b115ec4e18` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/minro/apis/minro-cs-platform/changes/api/v1/retention-changes/post.md)

---

[API](https://skmtc.dev/minro/apis/minro-cs-platform.md) · [All operations](https://skmtc.dev/minro/apis/minro-cs-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/minro/apis/minro-cs-platform/revisions/e309d6571e7b?raw)