---
title: "Archive, restore, or move a handover to trash"
method: POST
path: "/handovers/{id}/lifecycle"
---

# Archive, restore, or move a handover to trash

`POST /handovers/{id}/lifecycle`

## Request

- Base URL: `https://handover.sh/api/v1`
- URL: `https://handover.sh/api/v1/handovers/{id}/lifecycle`
- Auth: HTTP bearer

Trash is reversible for 30 days. Trashed handovers cannot receive revisions.

## Path parameters

- `id` string, required

## Request body

- HandoverLifecycleAction
  - `action` 'archive' | 'restore' | 'trash', required

## Response `200`

Updated handover snapshot

- HandoverEnvelope
  - `data` Handover, required
    - `id` string, required
    - `title` string, required
    - `summary` string
    - `status` 'active' | 'archived' | 'trashed', required
    - `visibility` 'workspace' | 'restricted', required
    - `deletedAt` string, date-time, nullable, required
    - `purgeAfter` string, date-time, nullable, required
    - `currentRevisionId` string, required
    - `currentRevision` object, required
    - `revisions` object[], required

## Other responses

- `403`: Request error

---

[API](https://skmtc.dev/handover/apis/handover-api.md) · [All operations](https://skmtc.dev/handover/apis/handover-api/llms.txt) · [OpenAPI document](https://skmtc.dev/handover/apis/handover-api/revisions/846b2a3091df?raw)