---
title: "Import OKF as an immutable revision"
method: POST
path: "/handovers/{id}/okf"
---

# Import OKF as an immutable revision

`POST /handovers/{id}/okf`

## Request

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

## Request body

- OkfBundle
  - `okfVersion` '0.1'
  - `handoverId` string
  - `revisionId` string
  - `expectedRevisionId` string
  - `mode` 'merge' | 'replace'
  - `files` OkfFile[], required
    - `path` string, required
    - `mediaType` string
    - `encoding` 'utf-8' | 'base64', required
    - `content` string, required
    - `byteSize` integer
    - `sha256` string

## Response `200`

Bundle was already imported

## Other responses

- `201`: Bundle imported

---

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