Skip to content
HALOWERK

Datenwerk

custody log

Takes the custody log you hold (a list of entries) and a new handover: actor, action (for example received, handed over, copied, analysed, returned), the item as SHA-256 or content, location and note. It first verifies every existing entry (each entry hash covers the previous hash and the canonical entry), reports the first broken link, then appends the new entry with the HALOWERK UTC time and returns the updated log and head hash, optionally anchored via OpenTimestamps. Nothing is stored at.

POST https://daten.halowerk.com/v1/custody-log

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
logarrayNo
entryobjectYes
anchorbooleanNoAlso anchor the result hash via OpenTimestamps (pending proof).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "entry"
  ],
  "properties": {
    "log": {
      "type": "array",
      "maxItems": 2000,
      "items": {
        "type": "object"
      }
    },
    "entry": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "actor",
        "action"
      ],
      "properties": {
        "actor": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "action": {
          "type": "string",
          "enum": [
            "created",
            "received",
            "handed_over",
            "copied",
            "analysed",
            "sealed",
            "returned",
            "destroyed",
            "note"
          ]
        },
        "item_sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "item_text": {
          "type": "string",
          "maxLength": 1000000
        },
        "item_base64": {
          "type": "string",
          "maxLength": 5000000
        },
        "location": {
          "type": "string",
          "maxLength": 300
        },
        "note": {
          "type": "string",
          "maxLength": 2000
        }
      }
    },
    "anchor": {
      "type": "boolean",
      "default": false,
      "description": "Also anchor the result hash via OpenTimestamps (pending proof)."
    }
  }
}

Open original schema

Published input example

{
  "entry": {
    "actor": "IT forensics desk",
    "action": "received",
    "item_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "location": "Gronau office"
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’