---
title: "Update history item"
method: PATCH
path: "/api/v1/history/{id4n}/{organizationId}/{sequenceId}"
tags: ["History"]
---

# Update history item

`PATCH /api/v1/history/{id4n}/{organizationId}/{sequenceId}`

## Path parameters

- `id4n` string, required
- `organizationId` string, required
- `sequenceId` integer, required

## Request body

- HistoryItemUpdate — GUID history item update (diff patch)
  - `organizationId` string — New organization id displayed for this item. If given, must match the holder of GUID and the organization the history item is found under.
  - `visibility` Visibility
    - `public` boolean — Document is publicly readable (if ID4N is owned by the same organization)
    - `sharedOrganizationIds` string[] — Document is readable by these organizations (independend of ID4N ownership)

## Response `200`

OK

- HistoryItem — GUID history item
  - `additionalProperties` object — History items custom additional properties
  - `organizationId` string, required — Originator of the history item
  - `ownerOrganizationId` string — Owner of the history item
  - `sequenceId` integer — Forms the primary key of the history item together with the GUID and the organizationId
  - `timestamp` integer — History item timestamp
  - `type` 'CREATED' | 'DESTROYED' | 'RECYCLED' | 'SHIPMENT_PREPARED' | 'STORED' | 'RETRIEVED_FROM_STORAGE' | 'PACKAGED' | 'DISPATCHED' | 'RECEIVED' | 'DELIVERY_REFUSED' | 'REPROCESSING_STARTED' | 'REPROCESSING_STEP_STARTED' | 'REPROCESSING_STEP_CANCELLED' | 'REPROCESSING_STEP_FINISHED' | 'REPROCESSING_CANCELLED' | 'REPROCESSING_FINISHED' | 'DISASSEMBLED' | 'MAINTENANCE_STARTED' | 'MAINTENANCE_STEP_STARTED' | 'MAINTENANCE_STEP_CANCELLED' | 'MAINTENANCE_STEP_FINISHED' | 'MAINTENANCE_CANCELLED' | 'MAINTENANCE_FINISHED' | 'PRODUCTION_STARTED' | 'PRODUCTION_CANCELLED' | 'PRODUCTION_FINISHED' | 'PRODUCTION_STEP_STARTED' | 'PRODUCTION_STEP_CANCELLED' | 'PRODUCTION_STEP_FINISHED' | 'QUALITY_CHECK_PERFORMED', required — Type of the history item
  - `visibility` Visibility
    - `public` boolean — Document is publicly readable (if ID4N is owned by the same organization)
    - `sharedOrganizationIds` string[] — Document is readable by these organizations (independend of ID4N ownership)

## Other responses

- `204` — No Content
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/id4i/apis/id4i-api.md) · [All operations](https://skmtc.dev/id4i/apis/id4i-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/id4i/id4i-api/revisions/b5f585ff1a29/schema)