Add DeviceIdentity example, validation + registration endpoint

examples/device_identity.json

@@ -0,0 +1,16 @@
+{
+  "id": "urn:srcos:device-identity:rack-01",
+  "type": "DeviceIdentity",
+  "specVersion": "2.0.0",
+  "deviceName": "rack-01",
+  "platform": "linux",
+  "archClass": "x86_64",
+  "trustProfile": {
+    "trustLevel": "provisional",
+    "enrolledAt": "2026-06-22T00:00:00Z"
+  },
+  "ownerRef": "urn:srcos:user:operator-9",
+  "registeredAt": "2026-06-22T00:00:00Z",
+  "policyDecisionRefs": [],
+  "evidenceRefs": []
+}

openapi.yaml

@@ -608,6 +608,33 @@ paths:
           description: Request body is valid JSON but fails schema validation.
           content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } }
 
+  /v2/device-identities:
+    post:
+      operationId: upsertDeviceIdentity
+      summary: Upsert a DeviceIdentity
+      description: Registers or updates a fleet device identity (name, platform, trust profile, owner) that NLBoot plans target and boot proofs reference. Idempotent on `id`.
+      tags: [Boot]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: './schemas/DeviceIdentity.json' }
+      responses:
+        '200':
+          description: DeviceIdentity registered or updated successfully.
+        '400':
+          description: Request body is malformed JSON.
+          content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } }
+        '401':
+          description: Missing or invalid authentication token.
+          content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } }
+        '403':
+          description: Authenticated subject is not permitted to register device identities.
+          content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } }
+        '422':
+          description: Request body is valid JSON but fails schema validation.
+          content: { application/json: { schema: { $ref: '#/components/schemas/Error' } } }
+
   /v2/apple-silicon-adapter-evidence:
     post:
       operationId: recordAppleSiliconAdapterEvidence

tools/validate_nlboot_examples.py

@@ -12,6 +12,7 @@
     (ROOT / "schemas" / "NLBootPlan.json", ROOT / "examples" / "nlboot_plan.json"),
     (ROOT / "schemas" / "ArtifactCacheRecord.json", ROOT / "examples" / "artifact_cache_record.json"),
     (ROOT / "schemas" / "BootProofRecord.json", ROOT / "examples" / "boot_proof_record.json"),
+    (ROOT / "schemas" / "DeviceIdentity.json", ROOT / "examples" / "device_identity.json"),
     (ROOT / "schemas" / "AppleSiliconAdapterEvidence.json", ROOT / "examples" / "apple_silicon_adapter_evidence.json"),
     # Release and build lifecycle objects
     (ROOT / "schemas" / "ReleaseSet.json", ROOT / "examples" / "release_set.json"),