---
title: "Add history item"
method: POST
path: "/api/v1/history/{id4n}"
tags: ["History"]
---

# Add history item

`POST /api/v1/history/{id4n}`

Add a new history item

## Path parameters

- `id4n` string, required

## Request body

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

## Response `200`

OK

## Other responses

- `201` — Created
- `202` — Accepted
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method not allowed
- `406` — Not Acceptable
- `409` — Conflict
- `415` — Unsupported Media Type
- `500` — Internal Server Error

---

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