---
title: "Retire the active policy version"
method: POST
path: "/v1/policies/{id}/retire"
tags: ["Policies"]
---

# Retire the active policy version

`POST /v1/policies/{id}/retire`

## Request

- Base URL: `https://api.thrd.email`
- URL: `https://api.thrd.email/v1/policies/{id}/retire`
- Auth: HTTP bearer

Requires policies:manage plus human admin authority. Draft documents are never made authorization authority by this route.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Admin-Token` string, required

## Request body

- object

## Response `200`

Retired version

- object
  - `version` object, required
    - `id` string, uuid, required
    - `tenantId` string, uuid, required
    - `environment` 'development' | 'staging' | 'production', required
    - `policyId` string, uuid, required
    - `version` integer, required
    - `status` 'draft' | 'active' | 'retired', required
    - `policyHash` string, required
    - `engineVersion` string, required
    - `documentJson` object, required
    - `createdAt` string, date-time, required
    - `activatedAt` string, date-time, nullable, required
    - `retiredAt` string, date-time, nullable, required

## Other responses

- `401`: Human admin authority required
- `409`: Version was never active

---

[API](https://skmtc.dev/thrd/apis/thrd-agent-email-api.md) · [All operations](https://skmtc.dev/thrd/apis/thrd-agent-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrd/apis/thrd-agent-email-api/revisions/d8a88129cd34?raw)