---
title: "Set retention policy"
method: POST
path: "/retention_policy"
tags: ["product:chat"]
---

# Set retention policy

`POST /retention_policy`

Creates or updates a retention policy for the app. Server-side only.

## Request body

- SetRetentionPolicyRequest, nullable
  - `max_age_hours` integer, required
  - `policy` 'old-messages' | 'inactive-channels', required

## Response `201`

Response

- SetRetentionPolicyResponse, nullable — Basic response information
  - `duration` string, required — Duration of the request in milliseconds
  - `policy` RetentionPolicy, required
    - `app_pk` integer, required
    - `config` PolicyConfig, required
      - `max_age_hours` integer, required
    - `enabled_at` string, date-time, required
    - `policy` string, required

## Other responses

- `400` — Bad request
- `429` — Too many requests

---

[API](https://skmtc.net/getstream/apis/stream-api.md) · [All operations](https://skmtc.net/getstream/apis/stream-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getstream/stream-api/versions/3dba86aaa0d8/schema)