---
title: "Set Retention Policy"
method: PUT
path: "/v1/scopes/{scope_name}/retention"
tags: ["governance"]
---

# Set Retention Policy

`PUT /v1/scopes/{scope_name}/retention`

## Request

- Base URL: `https://api.tmcra.com`
- URL: `https://api.tmcra.com/v1/scopes/{scope_name}/retention`
- Auth: HTTP bearer

## Path parameters

- `scope_name` string, required

## Headers

- `X-TMCRA-On-Behalf-Of-Subject` string, nullable: Trusted subject attribution for server-side control-plane proxies. Requires a tokens:manage API key.

## Request body

- RetentionPolicyRequest
  - `enabled` boolean, required
  - `inactive_days` integer, required

## Response `200`

Successful Response

- RetentionPolicyView
  - `created_at` number, nullable
  - `enabled` boolean, required
  - `inactive_days` integer, required
  - `scope_name` string, required
  - `updated_at` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tmcra/apis/tmcra-memory-api.md) · [All operations](https://skmtc.dev/tmcra/apis/tmcra-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tmcra/apis/tmcra-memory-api/revisions/597be9dc7a3d?raw)