---
title: "Changes to List retention rules"
method: GET
path: "/ocs/v2.php/apps/files_retention/api/v1/retentions"
---

# Changes to List retention rules

`GET /ocs/v2.php/apps/files_retention/api/v1/retentions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 4 revisions.

- **2025-12-20** `db5a22e1e7d3` — 2 info
- **2025-03-26** `e4e3f2a5e08a` — 6 warning
- **2025-03-26** `ae08f25fe8aa` — 8 info

## Changes

- **2025-12-20** `db5a22e1e7d3` — 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
- **2025-03-26** `e4e3f2a5e08a` — 6 warning
  - added the new `0.00` enum value to the `ocs/data/items/timeafter` response property for the response status `200`
  - added the new `0.00` enum value to the `ocs/data/items/timeunit` response property for the response status `200`
  - added the new `1.00` enum value to the `ocs/data/items/timeafter` response property for the response status `200`
  - added the new `1.00` enum value to the `ocs/data/items/timeunit` response property for the response status `200`
  - added the new `2.00` enum value to the `ocs/data/items/timeunit` response property for the response status `200`
  - added the new `3.00` enum value to the `ocs/data/items/timeunit` response property for the response status `200`
- **2025-03-26** `ae08f25fe8aa` — 8 info
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the `0.00` enum value from the `ocs/data/items/timeafter` response property for the response status `200`
  - removed the `0.00` enum value from the `ocs/data/items/timeunit` response property for the response status `200`
  - removed the `1.00` enum value from the `ocs/data/items/timeafter` response property for the response status `200`
  - removed the `1.00` enum value from the `ocs/data/items/timeunit` response property for the response status `200`
  - removed the `2.00` enum value from the `ocs/data/items/timeunit` response property for the response status `200`
  - removed the `3.00` enum value from the `ocs/data/items/timeunit` response property for the response status `200`

---

[Operation](https://skmtc.dev/nextcloud/apis/files-retention/docs/ocs/v2.php/apps/files_retention/api/v1/retentions/get.md) · [API](https://skmtc.dev/nextcloud/apis/files-retention.md) · [Page](https://skmtc.dev/nextcloud/apis/files-retention/changes/ocs/v2.php/apps/files_retention/api/v1/retentions/get)