From dcc4051286b1d16a9bea185a3ef6fcff636962eb Mon Sep 17 00:00:00 2001
From: Thomas Stallinger <stallinger@gmx.de>
Date: Tue, 14 Jul 2026 13:10:20 +0200
Subject: [PATCH] docs: document device registration status

---
 architecture/08-provisioning-api.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/architecture/08-provisioning-api.md b/architecture/08-provisioning-api.md
index 699c3d3..d1a89c7 100644
--- a/architecture/08-provisioning-api.md
+++ b/architecture/08-provisioning-api.md
@@ -96,7 +96,7 @@ Bei erfolgreicher Aktivierung antwortet der Provisioning-Server mit dem registri
     "id": "<device-uuid>",
     "fingerprint": "<sha256>",
     "hostname": "enterprise",
-    "created": false,
+    "registration_status": "existing", 
     "hardware_snapshot_id": "<hardware-snapshot-uuid>"
   },
   "customer": {
@@ -123,7 +123,11 @@ Bei erfolgreicher Aktivierung antwortet der Provisioning-Server mit dem registri
 
 `device.id` ist die interne, von Hardwaremerkmalen unabhängige Geräte-ID.
 
-`device.created` gibt an, ob das Gerät während dieses Aktivierungsvorgangs neu registriert wurde.
+`device.registration_status` beschreibt den Registrierungszustand des Geräts für den aktuellen Aktivierungsvorgang.
+
+Der Wert `registered` bedeutet, dass im Bootstrap-Modell ein neues Device registriert wurde.
+
+Der Wert `existing` bedeutet, dass ein bereits bekanntes Device anhand seines Hardware-Fingerprints wiedererkannt wurde.
 
 `device.hardware_snapshot_id` referenziert den für diesen Aktivierungsvorgang erzeugten Hardware-Snapshot.