---
title: "Changes to Delete retention policy"
method: POST
path: "/retention_policy/delete"
---

# Changes to Delete retention policy

`POST /retention_policy/delete`

> Every recorded change to this operation, newest first.
> 575 revisions in range; 3 not diffed.

## Timeline

Changed in 3 of 575 revisions.

- **2026-10-12** `30f95dce0284`: 2 info
- **2026-04-13** `0e8699ecb9d0`: 2 breaking, 2 info
- **2026-03-23** `8bf8e211736c`: 1 info

## Changes

- **2026-10-12** `30f95dce0284`: 2 info
  - added the optional property `cooldown_remaining_ms` to the response with the `400` status
  - added the optional property `cooldown_remaining_ms` to the response with the `429` status
- **2026-04-13** `0e8699ecb9d0`: 2 breaking, 2 info
  - request property `policy` was restricted to a list of enum values
  - the request property `policy` became required
  - added the new `inactive-channels` enum value to the request property `policy`
  - added the new `old-messages` enum value to the request property `policy`
- **2026-03-23** `8bf8e211736c`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getstream/apis/stream-api/docs/retention_policy/delete/post.md) - [API](https://skmtc.dev/getstream/apis/stream-api.md) - [Page](https://skmtc.dev/getstream/apis/stream-api/changes/retention_policy/delete/post)