---
title: "Continue a handover with a new immutable snapshot"
method: POST
path: "/handovers/{id}/revisions"
---

# Continue a handover with a new immutable snapshot

`POST /handovers/{id}/revisions`

## Request

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

Artifacts omitted from the request are inherited from the current revision. An artifact with the same case-insensitive name replaces the previous artifact in the new snapshot.

## Path parameters

- `id` string, required

## Request body

- AppendRevision
  - `note` string
  - `brief` ContinuationBrief: An immutable, structured snapshot of what a person or agent needs to resume the work.
    - `objective` string
    - `currentState` string
    - `decisions` string[]
    - `openQuestions` string[]
    - `nextSteps` ContinuationStep[]
      - `id` string, required
      - `text` string, required
      - `status` 'open' | 'done', required
  - `artifactMode` 'merge' | 'replace'
  - `artifacts` ArtifactInput[]
    - `name` string, required
    - `mediaType` string
    - `content` string, required
    - `encoding` 'utf8' | 'base64'
  - `expectedRevisionId` string

## Response `201`

Updated handover

- 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

- `409`: The expected revision is stale.

---

[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)