RubyGems - foil-server - Versions diffs - 0.4.0 → 0.5.0 - Mend

foil-server 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

checksums.yaml +4 -4
data/README.md +3 -1
data/lib/foil/server/client.rb +25 -4
data/lib/foil/server/sealed_token.rb +18 -1
data/lib/foil/server/version.rb +1 -1
data/spec/fixtures/api/fingerprints/detail.json +1 -1
data/spec/fixtures/api/fingerprints/list.json +1 -1
data/spec/fixtures/api/sessions/detail.json +10 -7
data/spec/fixtures/api/sessions/list.json +1 -0
data/spec/openapi.json +806 -324
metadata +2 -2

data/spec/openapi.json CHANGED Viewed

@@ -80,6 +80,28 @@
               "type": "string",
               "example": "arm"
             }
+          },
+          {
+            "name": "client_user_id",
+            "in": "query",
+            "description": "Returns only sessions whose `client_user_id` is exactly this value, case-sensitive, after trimming surrounding whitespace.",
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256,
+              "example": "user_123"
+            }
+          },
+          {
+            "name": "client_application_id",
+            "in": "query",
+            "description": "Returns only sessions whose `client_application_id` is exactly this value, case-sensitive, after trimming surrounding whitespace.",
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256,
+              "example": "app_123"
+            }
           }
         ],
         "responses": {
@@ -96,6 +118,7 @@
                         "id": "sid_87wfetm98myh9awj0dpt28a3kc",
                         "created_at": "2026-03-24T20:00:00.000Z",
                         "client_user_id": "user_123",
+                        "client_application_id": "app_123",
                         "latest_decision": {
                           "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
                           "verdict": "human",
@@ -273,6 +296,7 @@
                       "id": "sid_87wfetm98myh9awj0dpt28a3kc",
                       "created_at": "2026-03-24T20:00:00.000Z",
                       "client_user_id": "user_123",
+                      "client_application_id": "app_123",
                       "decision": {
                         "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
                         "automation_status": "automated",
@@ -316,7 +340,7 @@
                           "accuracy_radius_km": 10
                         },
                         "routing": {
-                          "asn": "64512",
+                          "asn": "AS64512",
                           "organization": "SPECTRANET LIMITED"
                         },
                         "anonymity": {
@@ -346,7 +370,7 @@
                           "client_types": [
                             "consumer"
                           ],
-                          "client_count": 1
+                          "client_count": null
                         },
                         "evaluated_at": "2026-03-24T20:00:05.000Z"
                       },
@@ -556,7 +580,8 @@
                         "lifecycle": {
                           "first_seen_at": "2026-03-01T18:22:11.000Z",
                           "last_seen_at": "2026-03-24T20:00:05.000Z",
-                          "seen_count": 1
+                          "seen_count": 1,
+                          "resolution_count": 1
                         }
                       },
                       "connection_fingerprint": {
@@ -674,7 +699,7 @@
                       "signals_fired": [
                         {
                           "signal": "webdriver_detected",
-                          "role": "owner",
+                          "role": "risk",
                           "category": "environment",
                           "strength": "definitive",
                           "signal_score": 100
@@ -711,9 +736,9 @@
                         },
                         "canvas": {
                           "hash": 1234567890,
-                          "geometry_hash": 1234567890,
+                          "geometry_hash": null,
                           "text_hash": 1234567890,
-                          "winding": true,
+                          "winding": null,
                           "noise_detected": true,
                           "offscreen_consistent": true
                         },
@@ -726,6 +751,7 @@
                             "parameters_hash": "01234567",
                             "extensions_hash": 1234567890,
                             "extension_parameters_hash": "01234567",
+                            "webgl2_parameters_hash": "01234567",
                             "shader_precision_hash": 1234567890
                           },
                           "webgpu": {
@@ -989,7 +1015,7 @@
             }
           }
         },
-        "description": "Set or clear the customer-supplied `client_user_id` for a session. Requires the `sessions:update` secret-key scope."
+        "description": "Set or clear the customer-supplied `client_user_id`, `client_application_id`, or both for a session. At least one key is required, a key you omit keeps its current value, and `null` clears it. Requires the `sessions:update` secret-key scope."
       }
     },
     "/v1/fingerprints": {
@@ -1056,23 +1082,23 @@
                           "first_seen_at": "2026-03-01T18:22:11.000Z",
                           "last_seen_at": "2026-03-24T20:00:05.000Z",
                           "seen_count": 14,
-                          "expires_at": "2026-03-24T20:00:05.000Z"
+                          "expires_at": "9999-12-31T00:00:00.000Z"
                         },
                         "latest_request": {
                           "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                           "ip_address": "203.0.113.10"
                         },
                         "storage": {
-                          "cookies": true,
-                          "local_storage": true,
-                          "indexed_db": true,
-                          "service_worker": true,
-                          "window_name": true
+                          "cookies": false,
+                          "local_storage": false,
+                          "indexed_db": false,
+                          "service_worker": false,
+                          "window_name": false
                         },
                         "anchors": {
-                          "webgl_hash": "123456789",
-                          "parameters_hash": "-1234567890",
-                          "audio_hash": "1234567890"
+                          "webgl_hash": null,
+                          "parameters_hash": null,
+                          "audio_hash": null
                         }
                       }
                     ],
@@ -1234,28 +1260,26 @@
                         "first_seen_at": "2026-03-01T18:22:11.000Z",
                         "last_seen_at": "2026-03-24T20:00:05.000Z",
                         "seen_count": 14,
-                        "expires_at": "2026-03-24T20:00:05.000Z"
+                        "expires_at": "9999-12-31T00:00:00.000Z"
                       },
                       "latest_request": {
                         "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                         "ip_address": "203.0.113.10"
                       },
                       "storage": {
-                        "cookies": true,
-                        "local_storage": true,
-                        "indexed_db": true,
-                        "service_worker": true,
-                        "window_name": true
+                        "cookies": false,
+                        "local_storage": false,
+                        "indexed_db": false,
+                        "service_worker": false,
+                        "window_name": false
                       },
                       "anchors": {
-                        "webgl_hash": "123456789",
-                        "parameters_hash": "-1234567890",
-                        "audio_hash": "1234567890"
+                        "webgl_hash": null,
+                        "parameters_hash": null,
+                        "audio_hash": null
                       },
                       "components": {
-                        "vector": [
-                          1.5
-                        ]
+                        "vector": []
                       },
                       "activity": {
                         "sessions": [
@@ -5329,11 +5353,25 @@
             "example": 94
           },
           "phase": {
-            "$ref": "#/components/schemas/Phase",
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/Phase",
+                "example": "snapshot"
+              },
+              {
+                "type": "null",
+                "example": null
+              }
+            ],
+            "description": "Null when the decision did not record it.",
             "example": "snapshot"
           },
           "is_provisional": {
-            "type": "boolean",
+            "type": [
+              "boolean",
+              "null"
+            ],
+            "description": "Null when the decision did not record it.",
             "example": false
           },
           "manipulation": {
@@ -5356,8 +5394,18 @@
             }
           },
           "evaluation_duration_ms": {
-            "type": "integer",
-            "minimum": 0,
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 0,
+                "example": 123
+              },
+              {
+                "type": "null",
+                "example": null
+              }
+            ],
+            "description": "Null when the decision did not record it.",
             "example": 123
           },
           "evaluated_at": {
@@ -5380,6 +5428,16 @@
           "evaluated_at": "2026-03-24T20:00:05.000Z"
         }
       },
+      "DeviceClass": {
+        "type": "string",
+        "enum": [
+          "desktop",
+          "phone",
+          "tablet",
+          "unknown"
+        ],
+        "example": "desktop"
+      },
       "Event": {
         "type": "object",
         "additionalProperties": false,
@@ -6636,6 +6694,12 @@
           },
           "engine": {
             "type": "string",
+            "enum": [
+              "blink",
+              "gecko",
+              "webkit",
+              "unknown"
+            ],
             "example": "blink"
           },
           "app_name": {
@@ -6707,9 +6771,9 @@
             "$ref": "#/components/schemas/SessionRawDeviceCanvas",
             "example": {
               "hash": 1234567890,
-              "geometry_hash": 1234567890,
+              "geometry_hash": null,
               "text_hash": 1234567890,
-              "winding": true,
+              "winding": null,
               "noise_detected": true,
               "offscreen_consistent": true
             }
@@ -6725,6 +6789,7 @@
                 "parameters_hash": "01234567",
                 "extensions_hash": 1234567890,
                 "extension_parameters_hash": "01234567",
+                "webgl2_parameters_hash": "01234567",
                 "shader_precision_hash": 1234567890
               },
               "webgpu": {
@@ -6805,9 +6870,9 @@
           },
           "canvas": {
             "hash": 1234567890,
-            "geometry_hash": 1234567890,
+            "geometry_hash": null,
             "text_hash": 1234567890,
-            "winding": true,
+            "winding": null,
             "noise_detected": true,
             "offscreen_consistent": true
           },
@@ -6820,6 +6885,7 @@
               "parameters_hash": "01234567",
               "extensions_hash": 1234567890,
               "extension_parameters_hash": "01234567",
+              "webgl2_parameters_hash": "01234567",
               "shader_precision_hash": 1234567890
             },
             "webgpu": {
@@ -6895,6 +6961,18 @@
                   "string",
                   "null"
                 ],
+                "enum": [
+                  "chrome",
+                  "firefox",
+                  "safari",
+                  "nodejs",
+                  "python",
+                  "go",
+                  "curl",
+                  "unknown",
+                  null
+                ],
+                "description": "Client the TLS fingerprint most resembles.",
                 "example": "chrome"
               },
               "family": {
@@ -6902,6 +6980,19 @@
                   "string",
                   "null"
                 ],
+                "enum": [
+                  "chromium",
+                  "firefox",
+                  "webkit",
+                  "nodejs",
+                  "python",
+                  "go",
+                  "curl",
+                  "middlebox",
+                  "unknown",
+                  null
+                ],
+                "description": "TLS stack family the JA4 fingerprint matches. `middlebox` means a TLS-intercepting proxy or security appliance.",
                 "example": "chromium"
               },
               "product": {
@@ -6916,6 +7007,14 @@
                   "string",
                   "null"
                 ],
+                "enum": [
+                  "exact",
+                  "strong",
+                  "heuristic",
+                  "unknown",
+                  null
+                ],
+                "description": "How closely the JA4 fingerprint matched a known client.",
                 "example": "exact"
               },
               "match_source": {
@@ -6923,6 +7022,15 @@
                   "string",
                   "null"
                 ],
+                "enum": [
+                  "full_ja4",
+                  "bc_hash",
+                  "cipher_hash",
+                  "prefix",
+                  "unknown",
+                  null
+                ],
+                "description": "Which part of the JA4 fingerprint produced the match: the full fingerprint, the cipher and extension hashes, the cipher hash alone, or the prefix.",
                 "example": "full_ja4"
               },
               "deterministic": {
@@ -6956,6 +7064,10 @@
                       },
                       "source": {
                         "type": "string",
+                        "enum": [
+                          "master_db",
+                          "heuristic"
+                        ],
                         "example": "master_db"
                       },
                       "protocol": {
@@ -7019,7 +7131,11 @@
                         }
                       },
                       "sample_size": {
-                        "type": "integer",
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "description": "Number of observations behind the reference. Null when the source does not report one.",
                         "example": 63
                       },
                       "verified": {
@@ -7122,6 +7238,19 @@
                   "string",
                   "null"
                 ],
+                "enum": [
+                  "chrome",
+                  "firefox",
+                  "safari",
+                  "edge",
+                  "nodejs",
+                  "python",
+                  "go",
+                  "curl",
+                  "unknown",
+                  null
+                ],
+                "description": "Client the HTTP/2 fingerprint most resembles.",
                 "example": "chrome"
               }
             },
@@ -7213,6 +7342,7 @@
           "signals_fired",
           "client_telemetry",
           "client_user_id",
+          "client_application_id",
           "behavior"
         ],
         "properties": {
@@ -7241,6 +7371,15 @@
             "description": "Customer-supplied identifier for the end user associated with this Foil session. Set with PATCH /v1/sessions/{sessionId}.",
             "example": "user_123"
           },
+          "client_application_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 256,
+            "description": "Customer-supplied identifier for the application or organization on your platform that this Foil session belongs to. Set with PATCH /v1/sessions/{sessionId}.",
+            "example": "app_123"
+          },
           "decision": {
             "$ref": "#/components/schemas/SessionDetailDecision",
             "example": {
@@ -7322,7 +7461,7 @@
                 "accuracy_radius_km": 10
               },
               "routing": {
-                "asn": "64512",
+                "asn": "AS64512",
                 "organization": "SPECTRANET LIMITED"
               },
               "anonymity": {
@@ -7352,7 +7491,7 @@
                 "client_types": [
                   "consumer"
                 ],
-                "client_count": 1
+                "client_count": null
               },
               "evaluated_at": "2026-03-24T20:00:05.000Z"
             }
@@ -7814,7 +7953,8 @@
                   "lifecycle": {
                     "first_seen_at": "2026-03-01T18:22:11.000Z",
                     "last_seen_at": "2026-03-24T20:00:05.000Z",
-                    "seen_count": 1
+                    "seen_count": 1,
+                    "resolution_count": 1
                   }
                 }
               },
@@ -7835,7 +7975,8 @@
               "lifecycle": {
                 "first_seen_at": "2026-03-01T18:22:11.000Z",
                 "last_seen_at": "2026-03-24T20:00:05.000Z",
-                "seen_count": 1
+                "seen_count": 1,
+                "resolution_count": 1
               }
             }
           },
@@ -7986,7 +8127,7 @@
               "$ref": "#/components/schemas/SessionSignalFired",
               "example": {
                 "signal": "webdriver_detected",
-                "role": "owner",
+                "role": "risk",
                 "category": "environment",
                 "strength": "definitive",
                 "signal_score": 100
@@ -7995,7 +8136,7 @@
             "example": [
               {
                 "signal": "webdriver_detected",
-                "role": "owner",
+                "role": "risk",
                 "category": "environment",
                 "strength": "definitive",
                 "signal_score": 100
@@ -8035,9 +8176,9 @@
               },
               "canvas": {
                 "hash": 1234567890,
-                "geometry_hash": 1234567890,
+                "geometry_hash": null,
                 "text_hash": 1234567890,
-                "winding": true,
+                "winding": null,
                 "noise_detected": true,
                 "offscreen_consistent": true
               },
@@ -8050,6 +8191,7 @@
                   "parameters_hash": "01234567",
                   "extensions_hash": 1234567890,
                   "extension_parameters_hash": "01234567",
+                  "webgl2_parameters_hash": "01234567",
                   "shader_precision_hash": 1234567890
                 },
                 "webgpu": {
@@ -8168,6 +8310,7 @@
           "id": "sid_87wfetm98myh9awj0dpt28a3kc",
           "created_at": "2026-03-24T20:00:00.000Z",
           "client_user_id": "user_123",
+          "client_application_id": "app_123",
           "decision": {
             "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
             "automation_status": "automated",
@@ -8211,7 +8354,7 @@
               "accuracy_radius_km": 10
             },
             "routing": {
-              "asn": "64512",
+              "asn": "AS64512",
               "organization": "SPECTRANET LIMITED"
             },
             "anonymity": {
@@ -8241,7 +8384,7 @@
               "client_types": [
                 "consumer"
               ],
-              "client_count": 1
+              "client_count": null
             },
             "evaluated_at": "2026-03-24T20:00:05.000Z"
           },
@@ -8451,7 +8594,8 @@
             "lifecycle": {
               "first_seen_at": "2026-03-01T18:22:11.000Z",
               "last_seen_at": "2026-03-24T20:00:05.000Z",
-              "seen_count": 1
+              "seen_count": 1,
+              "resolution_count": 1
             }
           },
           "connection_fingerprint": {
@@ -8569,7 +8713,7 @@
           "signals_fired": [
             {
               "signal": "webdriver_detected",
-              "role": "owner",
+              "role": "risk",
               "category": "environment",
               "strength": "definitive",
               "signal_score": 100
@@ -8606,9 +8750,9 @@
             },
             "canvas": {
               "hash": 1234567890,
-              "geometry_hash": 1234567890,
+              "geometry_hash": null,
               "text_hash": 1234567890,
-              "winding": true,
+              "winding": null,
               "noise_detected": true,
               "offscreen_consistent": true
             },
@@ -8621,6 +8765,7 @@
                 "parameters_hash": "01234567",
                 "extensions_hash": 1234567890,
                 "extension_parameters_hash": "01234567",
+                "webgl2_parameters_hash": "01234567",
                 "shader_precision_hash": 1234567890
               },
               "webgpu": {
@@ -8866,6 +9011,7 @@
               "machine_speed",
               "scripted_cadence",
               "filled_instantly",
+              "burst_fill",
               "changed",
               "visited_no_entry",
               "unknown"
@@ -9180,6 +9326,7 @@
               "id": "sid_87wfetm98myh9awj0dpt28a3kc",
               "created_at": "2026-03-24T20:00:00.000Z",
               "client_user_id": "user_123",
+              "client_application_id": "app_123",
               "decision": {
                 "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
                 "automation_status": "automated",
@@ -9223,7 +9370,7 @@
                   "accuracy_radius_km": 10
                 },
                 "routing": {
-                  "asn": "64512",
+                  "asn": "AS64512",
                   "organization": "SPECTRANET LIMITED"
                 },
                 "anonymity": {
@@ -9253,7 +9400,7 @@
                   "client_types": [
                     "consumer"
                   ],
-                  "client_count": 1
+                  "client_count": null
                 },
                 "evaluated_at": "2026-03-24T20:00:05.000Z"
               },
@@ -9463,7 +9610,8 @@
                 "lifecycle": {
                   "first_seen_at": "2026-03-01T18:22:11.000Z",
                   "last_seen_at": "2026-03-24T20:00:05.000Z",
-                  "seen_count": 1
+                  "seen_count": 1,
+                  "resolution_count": 1
                 }
               },
               "connection_fingerprint": {
@@ -9581,7 +9729,7 @@
               "signals_fired": [
                 {
                   "signal": "webdriver_detected",
-                  "role": "owner",
+                  "role": "risk",
                   "category": "environment",
                   "strength": "definitive",
                   "signal_score": 100
@@ -9618,9 +9766,9 @@
                 },
                 "canvas": {
                   "hash": 1234567890,
-                  "geometry_hash": 1234567890,
+                  "geometry_hash": null,
                   "text_hash": 1234567890,
-                  "winding": true,
+                  "winding": null,
                   "noise_detected": true,
                   "offscreen_consistent": true
                 },
@@ -9633,6 +9781,7 @@
                     "parameters_hash": "01234567",
                     "extensions_hash": 1234567890,
                     "extension_parameters_hash": "01234567",
+                    "webgl2_parameters_hash": "01234567",
                     "shader_precision_hash": 1234567890
                   },
                   "webgpu": {
@@ -9712,6 +9861,7 @@
             "id": "sid_87wfetm98myh9awj0dpt28a3kc",
             "created_at": "2026-03-24T20:00:00.000Z",
             "client_user_id": "user_123",
+            "client_application_id": "app_123",
             "decision": {
               "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
               "automation_status": "automated",
@@ -9755,7 +9905,7 @@
                 "accuracy_radius_km": 10
               },
               "routing": {
-                "asn": "64512",
+                "asn": "AS64512",
                 "organization": "SPECTRANET LIMITED"
               },
               "anonymity": {
@@ -9785,7 +9935,7 @@
                 "client_types": [
                   "consumer"
                 ],
-                "client_count": 1
+                "client_count": null
               },
               "evaluated_at": "2026-03-24T20:00:05.000Z"
             },
@@ -9995,7 +10145,8 @@
               "lifecycle": {
                 "first_seen_at": "2026-03-01T18:22:11.000Z",
                 "last_seen_at": "2026-03-24T20:00:05.000Z",
-                "seen_count": 1
+                "seen_count": 1,
+                "resolution_count": 1
               }
             },
             "connection_fingerprint": {
@@ -10113,7 +10264,7 @@
             "signals_fired": [
               {
                 "signal": "webdriver_detected",
-                "role": "owner",
+                "role": "risk",
                 "category": "environment",
                 "strength": "definitive",
                 "signal_score": 100
@@ -10150,9 +10301,9 @@
               },
               "canvas": {
                 "hash": 1234567890,
-                "geometry_hash": 1234567890,
+                "geometry_hash": null,
                 "text_hash": 1234567890,
-                "winding": true,
+                "winding": null,
                 "noise_detected": true,
                 "offscreen_consistent": true
               },
@@ -10165,6 +10316,7 @@
                   "parameters_hash": "01234567",
                   "extensions_hash": 1234567890,
                   "extension_parameters_hash": "01234567",
+                  "webgl2_parameters_hash": "01234567",
                   "shader_precision_hash": 1234567890
                 },
                 "webgpu": {
@@ -10295,15 +10447,12 @@
                 "enum": [
                   "continuity",
                   "fingerprint",
-                  "fingerprint_evolution",
                   "new",
                   "native_persistent",
                   "native_new",
-                  "existing",
-                  "unknown",
                   null
                 ],
-                "description": "The evidence that resolved this session to the visitor ID. Null when the session predates resolution tracking.",
+                "description": "The evidence that resolved this session to the visitor ID: `continuity` for an identifier saved in an earlier session, `fingerprint` for a fingerprint match, `new` for a first sighting, and `native_persistent` or `native_new` for iOS and Android SDK sessions. Null when the session predates resolution tracking.",
                 "example": "continuity"
               },
               "basis": {
@@ -10330,7 +10479,8 @@
             "example": {
               "first_seen_at": "2026-03-01T18:22:11.000Z",
               "last_seen_at": "2026-03-24T20:00:05.000Z",
-              "seen_count": 1
+              "seen_count": 1,
+              "resolution_count": 1
             }
           }
         },
@@ -10346,7 +10496,8 @@
           "lifecycle": {
             "first_seen_at": "2026-03-01T18:22:11.000Z",
             "last_seen_at": "2026-03-24T20:00:05.000Z",
-            "seen_count": 1
+            "seen_count": 1,
+            "resolution_count": 1
           }
         }
       },
@@ -10356,7 +10507,8 @@
         "required": [
           "first_seen_at",
           "last_seen_at",
-          "seen_count"
+          "seen_count",
+          "resolution_count"
         ],
         "properties": {
           "first_seen_at": {
@@ -10387,14 +10539,33 @@
                 "example": null
               }
             ],
+            "deprecated": true,
+            "description": "Deprecated. Same value as `resolution_count`. It does not match `seen_count` from `GET /v1/fingerprints/{visitorId}`, which counts sessions.",
             "example": 1
+          },
+          "resolution_count": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 0,
+                "example": 14
+              },
+              {
+                "type": "null",
+                "example": null
+              }
+            ],
+            "description": "Number of times Foil resolved a page load or app launch to this visitor ID across the organization, including both environments. One session can count more than once.",
+            "example": 14
           }
         },
         "example": {
           "first_seen_at": "2026-03-01T18:22:11.000Z",
           "last_seen_at": "2026-03-24T20:00:05.000Z",
-          "seen_count": 1
-        }
+          "seen_count": 1,
+          "resolution_count": 1
+        },
+        "description": "Lifecycle of the visitor ID across the organization, including both environments."
       },
       "SessionDevice": {
         "type": "object",
@@ -10409,7 +10580,7 @@
         ],
         "properties": {
           "form_factor": {
-            "type": "string",
+            "$ref": "#/components/schemas/DeviceClass",
             "example": "desktop"
           },
           "operating_system": {
@@ -10928,6 +11099,7 @@
                 "id": "sid_87wfetm98myh9awj0dpt28a3kc",
                 "created_at": "2026-03-24T20:00:00.000Z",
                 "client_user_id": "user_123",
+                "client_application_id": "app_123",
                 "latest_decision": {
                   "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
                   "verdict": "human",
@@ -10955,6 +11127,7 @@
                 "id": "sid_87wfetm98myh9awj0dpt28a3kc",
                 "created_at": "2026-03-24T20:00:00.000Z",
                 "client_user_id": "user_123",
+                "client_application_id": "app_123",
                 "latest_decision": {
                   "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
                   "verdict": "human",
@@ -10999,6 +11172,7 @@
               "id": "sid_87wfetm98myh9awj0dpt28a3kc",
               "created_at": "2026-03-24T20:00:00.000Z",
               "client_user_id": "user_123",
+              "client_application_id": "app_123",
               "latest_decision": {
                 "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
                 "verdict": "human",
@@ -12144,6 +12318,7 @@
               "string",
               "null"
             ],
+            "description": "Client IP address. Null when Foil did not capture one.",
             "example": "203.0.113.10"
           },
           "ip_version": {
@@ -12201,6 +12376,7 @@
                 "example": null
               }
             ],
+            "description": "Location of the IP address. Null when the lookup found none.",
             "example": {
               "city": "San Francisco",
               "region": "California",
@@ -12226,7 +12402,8 @@
                   "string",
                   "null"
                 ],
-                "example": "64512"
+                "description": "Autonomous system number with an `AS` prefix.",
+                "example": "AS64512"
               },
               "organization": {
                 "type": [
@@ -12237,7 +12414,7 @@
               }
             },
             "example": {
-              "asn": "64512",
+              "asn": "AS64512",
               "organization": "SPECTRANET LIMITED"
             }
           },
@@ -12281,6 +12458,8 @@
               },
               "callback_proxy": {
                 "type": "boolean",
+                "deprecated": true,
+                "description": "Always `false` for sessions evaluated since July 30, 2026. The current IP intelligence source has no callback-proxy classification.",
                 "example": false
               },
               "provider": {
@@ -12327,6 +12506,8 @@
               },
               "suspicious_network": {
                 "type": "boolean",
+                "deprecated": true,
+                "description": "Always `false` for sessions evaluated since July 30, 2026. The current IP intelligence source has no suspicious-network classification.",
                 "example": false
               }
             },
@@ -12390,7 +12571,9 @@
                     "example": null
                   }
                 ],
-                "example": 1
+                "deprecated": true,
+                "description": "Always `null` for sessions evaluated since July 30, 2026. The current IP intelligence source does not count clients behind an address.",
+                "example": null
               }
             },
             "example": {
@@ -12403,7 +12586,7 @@
               "client_types": [
                 "consumer"
               ],
-              "client_count": 1
+              "client_count": null
             }
           },
           "evaluated_at": {
@@ -12432,7 +12615,7 @@
             "accuracy_radius_km": 10
           },
           "routing": {
-            "asn": "64512",
+            "asn": "AS64512",
             "organization": "SPECTRANET LIMITED"
           },
           "anonymity": {
@@ -12462,7 +12645,7 @@
             "client_types": [
               "consumer"
             ],
-            "client_count": 1
+            "client_count": null
           },
           "evaluated_at": "2026-03-24T20:00:05.000Z"
         }
@@ -12609,7 +12792,8 @@
               "null"
             ],
             "minimum": 0,
-            "example": 3
+            "description": "The `maxChannelCount` of the audio output. Null when the browser did not report it.",
+            "example": 2
           },
           "voice_count": {
             "type": [
@@ -12670,7 +12854,9 @@
           },
           "geometry_hash": {
             "$ref": "#/components/schemas/ObservationHash",
-            "example": 1234567890
+            "deprecated": true,
+            "description": "Always null. Foil stopped measuring canvas geometry in July 2026.",
+            "example": null
           },
           "text_hash": {
             "$ref": "#/components/schemas/ObservationHash",
@@ -12681,7 +12867,9 @@
               "boolean",
               "null"
             ],
-            "example": true
+            "deprecated": true,
+            "description": "Always null. No Foil probe measures canvas winding.",
+            "example": null
           },
           "noise_detected": {
             "type": [
@@ -12700,9 +12888,9 @@
         },
         "example": {
           "hash": 1234567890,
-          "geometry_hash": 1234567890,
+          "geometry_hash": null,
           "text_hash": 1234567890,
-          "winding": true,
+          "winding": null,
           "noise_detected": true,
           "offscreen_consistent": true
         }
@@ -12725,6 +12913,7 @@
               "null"
             ],
             "minimum": 0,
+            "description": "Number of tested fonts that are installed.",
             "example": 3
           },
           "tested_count": {
@@ -12733,7 +12922,8 @@
               "null"
             ],
             "minimum": 0,
-            "example": 3
+            "description": "Number of fonts in the panel Foil tested. Null when the font probe returned no usable measurement.",
+            "example": 41
           },
           "enumeration_hash": {
             "$ref": "#/components/schemas/ObservationHash",
@@ -12749,7 +12939,8 @@
           },
           "emoji_hash": {
             "$ref": "#/components/schemas/ObservationHash",
-            "example": 1234567890
+            "description": "Hash of the rendered dimensions of a fixed set of emoji. Null when the browser could not measure them.",
+            "example": "5f0e2a71"
           }
         },
         "example": {
@@ -12779,6 +12970,7 @@
               "parameters_hash": "01234567",
               "extensions_hash": 1234567890,
               "extension_parameters_hash": "01234567",
+              "webgl2_parameters_hash": "01234567",
               "shader_precision_hash": 1234567890
             }
           },
@@ -12803,6 +12995,7 @@
             "parameters_hash": "01234567",
             "extensions_hash": 1234567890,
             "extension_parameters_hash": "01234567",
+            "webgl2_parameters_hash": "01234567",
             "shader_precision_hash": 1234567890
           },
           "webgpu": {
@@ -12826,6 +13019,7 @@
           "parameters_hash",
           "extensions_hash",
           "extension_parameters_hash",
+          "webgl2_parameters_hash",
           "shader_precision_hash"
         ],
         "properties": {
@@ -12867,6 +13061,13 @@
           },
           "extension_parameters_hash": {
             "$ref": "#/components/schemas/ObservationHash",
+            "deprecated": true,
+            "description": "Deprecated misnomer for `webgl2_parameters_hash`, which carries the same value. This field never described extension parameters.",
+            "example": "01234567"
+          },
+          "webgl2_parameters_hash": {
+            "$ref": "#/components/schemas/ObservationHash",
+            "description": "Hash of the WebGL2 context parameters. Null when WebGL2 is unavailable.",
             "example": "01234567"
           },
           "shader_precision_hash": {
@@ -12882,6 +13083,7 @@
           "parameters_hash": "01234567",
           "extensions_hash": 1234567890,
           "extension_parameters_hash": "01234567",
+          "webgl2_parameters_hash": "01234567",
           "shader_precision_hash": 1234567890
         }
       },
@@ -13145,6 +13347,7 @@
       "SessionRawDeviceStorage": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Whether each storage API is available to the page. A field is `true` when a probe found the API or Foil read its own identifier back from that store, `false` only when a probe found the API missing, and `null` when nothing measured it. A missing identifier is not evidence that the store is unavailable.",
         "required": [
           "cookies",
           "local_storage",
@@ -13159,6 +13362,7 @@
               "boolean",
               "null"
             ],
+            "description": "From `navigator.cookieEnabled`. Otherwise `true` when Foil read its cookie back, and `null`.",
             "example": true
           },
           "local_storage": {
@@ -13166,6 +13370,7 @@
               "boolean",
               "null"
             ],
+            "description": "Whether `window.localStorage` is reachable. Otherwise `true` when Foil read its identifier back, and `null`.",
             "example": true
           },
           "session_storage": {
@@ -13173,6 +13378,7 @@
               "boolean",
               "null"
             ],
+            "description": "Whether `window.sessionStorage` is reachable. Otherwise `true` when Foil read its identifier back, and `null`.",
             "example": true
           },
           "indexed_db": {
@@ -13180,6 +13386,7 @@
               "boolean",
               "null"
             ],
+            "description": "`true` when Foil read its identifier back from IndexedDB, otherwise `null`. No probe tests IndexedDB directly, so this field is never `false`.",
             "example": true
           },
           "service_worker": {
@@ -13187,6 +13394,7 @@
               "boolean",
               "null"
             ],
+            "description": "Whether `navigator.serviceWorker` exists. Null when the probe did not run.",
             "example": true
           },
           "window_name": {
@@ -13194,6 +13402,7 @@
               "boolean",
               "null"
             ],
+            "description": "`true` when Foil read its identifier back from `window.name`, otherwise `null`. This field is never `false`.",
             "example": true
           }
         },
@@ -13215,6 +13424,7 @@
           "event",
           "decision",
           "visitor_fingerprint",
+          "device_cluster",
           "request",
           "score_breakdown",
           "signals",
@@ -13259,14 +13469,24 @@
               },
               "scoring_event_id": {
                 "type": "string",
-                "example": "scoring_event_id"
+                "example": "1842"
               },
               "phase": {
-                "type": [
-                  "string",
-                  "null"
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "snapshot",
+                      "behavioral"
+                    ],
+                    "example": "behavioral"
+                  },
+                  {
+                    "type": "null",
+                    "example": null
+                  }
                 ],
-                "example": "phase"
+                "example": "behavioral"
               },
               "is_provisional": {
                 "type": [
@@ -13283,8 +13503,8 @@
             },
             "example": {
               "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-              "scoring_event_id": "scoring_event_id",
-              "phase": "phase",
+              "scoring_event_id": "1842",
+              "phase": "behavioral",
               "is_provisional": false,
               "persisted_at": "2026-03-24T20:00:05.000Z"
             }
@@ -13301,27 +13521,29 @@
             "properties": {
               "verdict": {
                 "$ref": "#/components/schemas/Verdict",
-                "example": "human"
+                "example": "bot"
               },
               "risk_score": {
                 "type": "integer",
                 "minimum": 0,
                 "maximum": 100,
-                "example": 94
+                "example": 94,
+                "description": "The risk score as an integer from 0 to 100."
               },
               "score": {
                 "type": "number",
                 "minimum": 0,
                 "maximum": 1,
-                "example": 0.08
+                "example": 0.94,
+                "description": "The same risk score as a number from 0 to 1."
               },
               "manipulation": {
                 "anyOf": [
                   {
                     "$ref": "#/components/schemas/ManipulationSummary",
                     "example": {
-                      "score": 1,
-                      "verdict": "none"
+                      "score": 18,
+                      "verdict": "low"
                     }
                   },
                   {
@@ -13330,18 +13552,18 @@
                   }
                 ],
                 "example": {
-                  "score": 1,
-                  "verdict": "none"
+                  "score": 18,
+                  "verdict": "low"
                 }
               }
             },
             "example": {
-              "verdict": "human",
+              "verdict": "bot",
               "risk_score": 94,
-              "score": 0.08,
+              "score": 0.94,
               "manipulation": {
-                "score": 1,
-                "verdict": "none"
+                "score": 18,
+                "verdict": "low"
               }
             }
           },
@@ -13372,6 +13594,81 @@
               "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
             }
           },
+          "device_cluster": {
+            "description": "The device cluster Foil linked the visitor to, or null when device-cluster results are not enabled.",
+            "anyOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "object",
+                  "id",
+                  "confidence",
+                  "matched_by"
+                ],
+                "properties": {
+                  "object": {
+                    "type": "string",
+                    "const": "device_cluster",
+                    "example": "device_cluster"
+                  },
+                  "id": {
+                    "type": "string",
+                    "example": "dcl_3k9vb7xq2m8n4c6p1r5t0wyzhe"
+                  },
+                  "confidence": {
+                    "anyOf": [
+                      {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 100,
+                        "example": 88
+                      },
+                      {
+                        "type": "null",
+                        "example": null
+                      }
+                    ],
+                    "example": 88
+                  },
+                  "matched_by": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "visitor_membership",
+                          "fingerprint",
+                          "new"
+                        ],
+                        "example": "fingerprint"
+                      },
+                      {
+                        "type": "null",
+                        "example": null
+                      }
+                    ],
+                    "example": "fingerprint"
+                  }
+                },
+                "example": {
+                  "object": "device_cluster",
+                  "id": "dcl_3k9vb7xq2m8n4c6p1r5t0wyzhe",
+                  "confidence": 88,
+                  "matched_by": "fingerprint"
+                }
+              },
+              {
+                "type": "null",
+                "example": null
+              }
+            ],
+            "example": {
+              "object": "device_cluster",
+              "id": "dcl_3k9vb7xq2m8n4c6p1r5t0wyzhe",
+              "confidence": 88,
+              "matched_by": "fingerprint"
+            }
+          },
           "request": {
             "$ref": "#/components/schemas/WebhookRequestSummary",
             "example": {
@@ -13379,42 +13676,61 @@
               "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
               "ip_address": "203.0.113.10",
               "screen_size": "1440x900",
-              "is_touch_capable": true,
+              "is_touch_capable": false,
               "platform": "macOS",
-              "first_seen": "2026-03-01T18:22:11.000Z",
+              "first_seen": "2026-03-24T19:59:58.000Z",
               "risk_time": "2026-03-24T20:00:05.000Z"
             }
           },
           "score_breakdown": {
             "type": "object",
-            "additionalProperties": true,
+            "additionalProperties": false,
             "required": [
               "categories"
             ],
             "properties": {
               "categories": {
                 "type": "object",
-                "additionalProperties": true,
+                "description": "Each scoring category mapped to its score, an integer from 0 to 100.",
+                "additionalProperties": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 100,
+                  "example": 60
+                },
                 "example": {
-                  "source": "signup_form"
+                  "environment": 60,
+                  "fingerprint": 30,
+                  "keyboard": 10
                 }
               }
             },
             "example": {
               "categories": {
-                "source": "signup_form"
+                "environment": 60,
+                "fingerprint": 30,
+                "keyboard": 10
               }
             }
           },
           "signals": {
             "type": "array",
+            "description": "The risk signals that fired for the decision. Shadow and telemetry-only signals are never included. Empty unless the organization's plan includes raw signals.",
             "items": {
               "type": "object",
-              "additionalProperties": true,
+              "additionalProperties": false,
+              "required": [
+                "id",
+                "category",
+                "confidence",
+                "score",
+                "role"
+              ],
               "properties": {
                 "id": {
                   "type": "string",
-                  "example": "sid_87wfetm98myh9awj0dpt28a3kc"
+                  "description": "An opaque signal identifier.",
+                  "example": "E1"
                 },
                 "category": {
                   "type": "string",
@@ -13425,50 +13741,88 @@
                   "example": "exact"
                 },
                 "score": {
-                  "type": "number",
-                  "example": 0.08
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 100,
+                  "description": "The signal's contribution as an integer from 0 to 100.",
+                  "example": 60
                 },
                 "role": {
                   "type": "string",
-                  "example": "owner"
+                  "const": "risk",
+                  "example": "risk"
                 }
               },
               "example": {
-                "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                "id": "E1",
                 "category": "environment",
                 "confidence": "exact",
-                "score": 0.08,
-                "role": "owner"
+                "score": 60,
+                "role": "risk"
               }
             },
             "example": [
               {
-                "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                "id": "E1",
                 "category": "environment",
                 "confidence": "exact",
-                "score": 0.08,
-                "role": "owner"
+                "score": 60,
+                "role": "risk"
               }
             ]
           },
           "attribution": {
             "type": "object",
-            "additionalProperties": true,
+            "additionalProperties": false,
+            "required": [
+              "bot"
+            ],
             "properties": {
               "bot": {
-                "type": [
-                  "object",
-                  "null"
+                "anyOf": [
+                  {
+                    "$ref": "#/components/schemas/SessionAttribution",
+                    "example": {
+                      "labels": [
+                        {
+                          "kind": "actor",
+                          "value": "automation",
+                          "label": "Automation",
+                          "confidence": 97
+                        }
+                      ],
+                      "behaviors": []
+                    }
+                  },
+                  {
+                    "type": "null",
+                    "example": null
+                  }
                 ],
-                "additionalProperties": true,
                 "example": {
-                  "source": "signup_form"
+                  "labels": [
+                    {
+                      "kind": "actor",
+                      "value": "automation",
+                      "label": "Automation",
+                      "confidence": 97
+                    }
+                  ],
+                  "behaviors": []
                 }
               }
             },
             "example": {
               "bot": {
-                "source": "signup_form"
+                "labels": [
+                  {
+                    "kind": "actor",
+                    "value": "automation",
+                    "label": "Automation",
+                    "confidence": 97
+                  }
+                ],
+                "behaviors": []
               }
             }
           }
@@ -13480,50 +13834,61 @@
           },
           "event": {
             "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-            "scoring_event_id": "scoring_event_id",
-            "phase": "phase",
+            "scoring_event_id": "1842",
+            "phase": "behavioral",
             "is_provisional": false,
             "persisted_at": "2026-03-24T20:00:05.000Z"
           },
           "decision": {
-            "verdict": "human",
+            "verdict": "bot",
             "risk_score": 94,
-            "score": 0.08,
+            "score": 0.94,
             "manipulation": {
-              "score": 1,
-              "verdict": "none"
+              "score": 18,
+              "verdict": "low"
             }
           },
           "visitor_fingerprint": {
             "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
           },
+          "device_cluster": null,
           "request": {
             "url": "https://app.acme.co/signup",
             "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
             "ip_address": "203.0.113.10",
             "screen_size": "1440x900",
-            "is_touch_capable": true,
+            "is_touch_capable": false,
             "platform": "macOS",
-            "first_seen": "2026-03-01T18:22:11.000Z",
+            "first_seen": "2026-03-24T19:59:58.000Z",
             "risk_time": "2026-03-24T20:00:05.000Z"
           },
           "score_breakdown": {
             "categories": {
-              "source": "signup_form"
+              "environment": 60,
+              "fingerprint": 30,
+              "keyboard": 10
             }
           },
           "signals": [
             {
-              "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+              "id": "E1",
               "category": "environment",
               "confidence": "exact",
-              "score": 0.08,
-              "role": "owner"
+              "score": 60,
+              "role": "risk"
             }
           ],
           "attribution": {
             "bot": {
-              "source": "signup_form"
+              "labels": [
+                {
+                  "kind": "actor",
+                  "value": "automation",
+                  "label": "Automation",
+                  "confidence": 97
+                }
+              ],
+              "behaviors": []
             }
           }
         }
@@ -13544,50 +13909,61 @@
                 },
                 "event": {
                   "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-                  "scoring_event_id": "scoring_event_id",
-                  "phase": "phase",
+                  "scoring_event_id": "1842",
+                  "phase": "behavioral",
                   "is_provisional": false,
                   "persisted_at": "2026-03-24T20:00:05.000Z"
                 },
                 "decision": {
-                  "verdict": "human",
+                  "verdict": "bot",
                   "risk_score": 94,
-                  "score": 0.08,
+                  "score": 0.94,
                   "manipulation": {
-                    "score": 1,
-                    "verdict": "none"
+                    "score": 18,
+                    "verdict": "low"
                   }
                 },
                 "visitor_fingerprint": {
                   "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
                 },
+                "device_cluster": null,
                 "request": {
                   "url": "https://app.acme.co/signup",
                   "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                   "ip_address": "203.0.113.10",
                   "screen_size": "1440x900",
-                  "is_touch_capable": true,
+                  "is_touch_capable": false,
                   "platform": "macOS",
-                  "first_seen": "2026-03-01T18:22:11.000Z",
+                  "first_seen": "2026-03-24T19:59:58.000Z",
                   "risk_time": "2026-03-24T20:00:05.000Z"
                 },
                 "score_breakdown": {
                   "categories": {
-                    "source": "signup_form"
+                    "environment": 60,
+                    "fingerprint": 30,
+                    "keyboard": 10
                   }
                 },
                 "signals": [
                   {
-                    "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                    "id": "E1",
                     "category": "environment",
                     "confidence": "exact",
-                    "score": 0.08,
-                    "role": "owner"
+                    "score": 60,
+                    "role": "risk"
                   }
                 ],
                 "attribution": {
                   "bot": {
-                    "source": "signup_form"
+                    "labels": [
+                      {
+                        "kind": "actor",
+                        "value": "automation",
+                        "label": "Automation",
+                        "confidence": 97
+                      }
+                    ],
+                    "behaviors": []
                   }
                 }
               }
@@ -13610,50 +13986,61 @@
               },
               "event": {
                 "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-                "scoring_event_id": "scoring_event_id",
-                "phase": "phase",
+                "scoring_event_id": "1842",
+                "phase": "behavioral",
                 "is_provisional": false,
                 "persisted_at": "2026-03-24T20:00:05.000Z"
               },
               "decision": {
-                "verdict": "human",
+                "verdict": "bot",
                 "risk_score": 94,
-                "score": 0.08,
+                "score": 0.94,
                 "manipulation": {
-                  "score": 1,
-                  "verdict": "none"
+                  "score": 18,
+                  "verdict": "low"
                 }
               },
               "visitor_fingerprint": {
                 "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
               },
+              "device_cluster": null,
               "request": {
                 "url": "https://app.acme.co/signup",
                 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                 "ip_address": "203.0.113.10",
                 "screen_size": "1440x900",
-                "is_touch_capable": true,
+                "is_touch_capable": false,
                 "platform": "macOS",
-                "first_seen": "2026-03-01T18:22:11.000Z",
+                "first_seen": "2026-03-24T19:59:58.000Z",
                 "risk_time": "2026-03-24T20:00:05.000Z"
               },
               "score_breakdown": {
                 "categories": {
-                  "source": "signup_form"
+                  "environment": 60,
+                  "fingerprint": 30,
+                  "keyboard": 10
                 }
               },
               "signals": [
                 {
-                  "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                  "id": "E1",
                   "category": "environment",
                   "confidence": "exact",
-                  "score": 0.08,
-                  "role": "owner"
+                  "score": 60,
+                  "role": "risk"
                 }
               ],
               "attribution": {
                 "bot": {
-                  "source": "signup_form"
+                  "labels": [
+                    {
+                      "kind": "actor",
+                      "value": "automation",
+                      "label": "Automation",
+                      "confidence": 97
+                    }
+                  ],
+                  "behaviors": []
                 }
               }
             }
@@ -13671,50 +14058,61 @@
             },
             "event": {
               "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-              "scoring_event_id": "scoring_event_id",
-              "phase": "phase",
+              "scoring_event_id": "1842",
+              "phase": "behavioral",
               "is_provisional": false,
               "persisted_at": "2026-03-24T20:00:05.000Z"
             },
             "decision": {
-              "verdict": "human",
+              "verdict": "bot",
               "risk_score": 94,
-              "score": 0.08,
+              "score": 0.94,
               "manipulation": {
-                "score": 1,
-                "verdict": "none"
+                "score": 18,
+                "verdict": "low"
               }
             },
             "visitor_fingerprint": {
               "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
             },
+            "device_cluster": null,
             "request": {
               "url": "https://app.acme.co/signup",
               "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
               "ip_address": "203.0.113.10",
               "screen_size": "1440x900",
-              "is_touch_capable": true,
+              "is_touch_capable": false,
               "platform": "macOS",
-              "first_seen": "2026-03-01T18:22:11.000Z",
+              "first_seen": "2026-03-24T19:59:58.000Z",
               "risk_time": "2026-03-24T20:00:05.000Z"
             },
             "score_breakdown": {
               "categories": {
-                "source": "signup_form"
+                "environment": 60,
+                "fingerprint": 30,
+                "keyboard": 10
               }
             },
             "signals": [
               {
-                "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                "id": "E1",
                 "category": "environment",
                 "confidence": "exact",
-                "score": 0.08,
-                "role": "owner"
+                "score": 60,
+                "role": "risk"
               }
             ],
             "attribution": {
               "bot": {
-                "source": "signup_form"
+                "labels": [
+                  {
+                    "kind": "actor",
+                    "value": "automation",
+                    "label": "Automation",
+                    "confidence": 97
+                  }
+                ],
+                "behaviors": []
               }
             }
           }
@@ -13845,14 +14243,33 @@
           },
           "role": {
             "type": "string",
-            "example": "owner"
+            "enum": [
+              "risk"
+            ],
+            "description": "Always `risk`: only signals that counted toward the risk score are listed.",
+            "example": "risk"
           },
           "category": {
             "type": "string",
+            "enum": [
+              "environment",
+              "eventTrust",
+              "fingerprint",
+              "mouse",
+              "keyboard",
+              "timing",
+              "touch"
+            ],
             "example": "environment"
           },
           "strength": {
             "type": "string",
+            "enum": [
+              "definitive",
+              "strong",
+              "behavioral",
+              "weak"
+            ],
             "example": "definitive"
           },
           "signal_score": {
@@ -13864,7 +14281,7 @@
         },
         "example": {
           "signal": "webdriver_detected",
-          "role": "owner",
+          "role": "risk",
           "category": "environment",
           "strength": "definitive",
           "signal_score": 100
@@ -13879,7 +14296,8 @@
           "created_at",
           "latest_decision",
           "visitor_fingerprint",
-          "client_user_id"
+          "client_user_id",
+          "client_application_id"
         ],
         "properties": {
           "object": {
@@ -13907,6 +14325,15 @@
             "description": "Customer-supplied identifier for the end user associated with this Foil session. Set with PATCH /v1/sessions/{sessionId}.",
             "example": "user_123"
           },
+          "client_application_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 256,
+            "description": "Customer-supplied identifier for the application or organization on your platform that this Foil session belongs to. Set with PATCH /v1/sessions/{sessionId}.",
+            "example": "app_123"
+          },
           "latest_decision": {
             "$ref": "#/components/schemas/Decision",
             "example": {
@@ -13952,6 +14379,7 @@
           "id": "sid_87wfetm98myh9awj0dpt28a3kc",
           "created_at": "2026-03-24T20:00:00.000Z",
           "client_user_id": "user_123",
+          "client_application_id": "app_123",
           "latest_decision": {
             "event_id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
             "verdict": "human",
@@ -13986,6 +14414,14 @@
               "string",
               "null"
             ],
+            "enum": [
+              "verified",
+              "invalid",
+              "error",
+              "absent",
+              null
+            ],
+            "description": "Result of checking the request's Web Bot Auth signature. `absent` means the request carried no signature.",
             "example": "verified"
           },
           "domain": {
@@ -14087,9 +14523,8 @@
       "UpdateSessionRequest": {
         "type": "object",
         "additionalProperties": false,
-        "required": [
-          "client_user_id"
-        ],
+        "minProperties": 1,
+        "description": "Send `client_user_id`, `client_application_id`, or both. At least one is required. A key you omit keeps its current value, and `null` clears it.",
         "properties": {
           "client_user_id": {
             "type": [
@@ -14099,10 +14534,20 @@
             "maxLength": 256,
             "description": "Customer-supplied identifier for the end user associated with this Foil session. Set with PATCH /v1/sessions/{sessionId}.",
             "example": "user_123"
+          },
+          "client_application_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 256,
+            "description": "Customer-supplied identifier for the application or organization on your platform that this Foil session belongs to. Set with PATCH /v1/sessions/{sessionId}.",
+            "example": "app_123"
           }
         },
         "example": {
-          "client_user_id": "user_123"
+          "client_user_id": "user_123",
+          "client_application_id": "app_123"
         }
       },
       "UpdateWebhookEndpointRequest": {
@@ -14340,6 +14785,8 @@
       "VisitorFingerprintAnchors": {
         "type": "object",
         "additionalProperties": false,
+        "deprecated": true,
+        "description": "Always `null` from `/v1/fingerprints`. The identity record behind this field spans both environments, so `/v1/fingerprints` cannot attribute it to your key's environment.",
         "required": [
           "webgl_hash",
           "parameters_hash",
@@ -14369,9 +14816,9 @@
           }
         },
         "example": {
-          "webgl_hash": "123456789",
-          "parameters_hash": "-1234567890",
-          "audio_hash": "1234567890"
+          "webgl_hash": null,
+          "parameters_hash": null,
+          "audio_hash": null
         }
       },
       "VisitorFingerprintComponents": {
@@ -14387,15 +14834,13 @@
               "type": "number",
               "example": 1.5
             },
-            "example": [
-              1.5
-            ]
+            "deprecated": true,
+            "description": "Always empty from `/v1/fingerprints`. The identity record behind this field spans both environments, so `/v1/fingerprints` cannot attribute it to your key's environment.",
+            "example": []
           }
         },
         "example": {
-          "vector": [
-            1.5
-          ]
+          "vector": []
         }
       },
       "VisitorFingerprintDetail": {
@@ -14426,7 +14871,7 @@
               "first_seen_at": "2026-03-01T18:22:11.000Z",
               "last_seen_at": "2026-03-24T20:00:05.000Z",
               "seen_count": 14,
-              "expires_at": "2026-03-24T20:00:05.000Z"
+              "expires_at": "9999-12-31T00:00:00.000Z"
             }
           },
           "latest_request": {
@@ -14449,17 +14894,15 @@
           "anchors": {
             "$ref": "#/components/schemas/VisitorFingerprintAnchors",
             "example": {
-              "webgl_hash": "123456789",
-              "parameters_hash": "-1234567890",
-              "audio_hash": "1234567890"
+              "webgl_hash": null,
+              "parameters_hash": null,
+              "audio_hash": null
             }
           },
           "components": {
             "$ref": "#/components/schemas/VisitorFingerprintComponents",
             "example": {
-              "vector": [
-                1.5
-              ]
+              "vector": []
             }
           },
           "activity": {
@@ -14505,28 +14948,26 @@
             "first_seen_at": "2026-03-01T18:22:11.000Z",
             "last_seen_at": "2026-03-24T20:00:05.000Z",
             "seen_count": 14,
-            "expires_at": "2026-03-24T20:00:05.000Z"
+            "expires_at": "9999-12-31T00:00:00.000Z"
           },
           "latest_request": {
             "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
             "ip_address": "203.0.113.10"
           },
           "storage": {
-            "cookies": true,
-            "local_storage": true,
-            "indexed_db": true,
-            "service_worker": true,
-            "window_name": true
+            "cookies": false,
+            "local_storage": false,
+            "indexed_db": false,
+            "service_worker": false,
+            "window_name": false
           },
           "anchors": {
-            "webgl_hash": "123456789",
-            "parameters_hash": "-1234567890",
-            "audio_hash": "1234567890"
+            "webgl_hash": null,
+            "parameters_hash": null,
+            "audio_hash": null
           },
           "components": {
-            "vector": [
-              1.5
-            ]
+            "vector": []
           },
           "activity": {
             "sessions": [
@@ -14579,28 +15020,26 @@
                 "first_seen_at": "2026-03-01T18:22:11.000Z",
                 "last_seen_at": "2026-03-24T20:00:05.000Z",
                 "seen_count": 14,
-                "expires_at": "2026-03-24T20:00:05.000Z"
+                "expires_at": "9999-12-31T00:00:00.000Z"
               },
               "latest_request": {
                 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                 "ip_address": "203.0.113.10"
               },
               "storage": {
-                "cookies": true,
-                "local_storage": true,
-                "indexed_db": true,
-                "service_worker": true,
-                "window_name": true
+                "cookies": false,
+                "local_storage": false,
+                "indexed_db": false,
+                "service_worker": false,
+                "window_name": false
               },
               "anchors": {
-                "webgl_hash": "123456789",
-                "parameters_hash": "-1234567890",
-                "audio_hash": "1234567890"
+                "webgl_hash": null,
+                "parameters_hash": null,
+                "audio_hash": null
               },
               "components": {
-                "vector": [
-                  1.5
-                ]
+                "vector": []
               },
               "activity": {
                 "sessions": [
@@ -14651,28 +15090,26 @@
               "first_seen_at": "2026-03-01T18:22:11.000Z",
               "last_seen_at": "2026-03-24T20:00:05.000Z",
               "seen_count": 14,
-              "expires_at": "2026-03-24T20:00:05.000Z"
+              "expires_at": "9999-12-31T00:00:00.000Z"
             },
             "latest_request": {
               "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
               "ip_address": "203.0.113.10"
             },
             "storage": {
-              "cookies": true,
-              "local_storage": true,
-              "indexed_db": true,
-              "service_worker": true,
-              "window_name": true
+              "cookies": false,
+              "local_storage": false,
+              "indexed_db": false,
+              "service_worker": false,
+              "window_name": false
             },
             "anchors": {
-              "webgl_hash": "123456789",
-              "parameters_hash": "-1234567890",
-              "audio_hash": "1234567890"
+              "webgl_hash": null,
+              "parameters_hash": null,
+              "audio_hash": null
             },
             "components": {
-              "vector": [
-                1.5
-              ]
+              "vector": []
             },
             "activity": {
               "sessions": [
@@ -14757,19 +15194,22 @@
           "seen_count": {
             "type": "integer",
             "minimum": 0,
+            "description": "Number of sessions linked to this visitor ID in your key's environment.",
             "example": 14
           },
           "expires_at": {
             "type": "string",
             "format": "date-time",
-            "example": "2026-03-24T20:00:05.000Z"
+            "deprecated": true,
+            "description": "Always `9999-12-31T00:00:00.000Z`. Visitor IDs do not expire.",
+            "example": "9999-12-31T00:00:00.000Z"
           }
         },
         "example": {
           "first_seen_at": "2026-03-01T18:22:11.000Z",
           "last_seen_at": "2026-03-24T20:00:05.000Z",
           "seen_count": 14,
-          "expires_at": "2026-03-24T20:00:05.000Z"
+          "expires_at": "9999-12-31T00:00:00.000Z"
         }
       },
       "VisitorFingerprintLink": {
@@ -14841,23 +15281,23 @@
                   "first_seen_at": "2026-03-01T18:22:11.000Z",
                   "last_seen_at": "2026-03-24T20:00:05.000Z",
                   "seen_count": 14,
-                  "expires_at": "2026-03-24T20:00:05.000Z"
+                  "expires_at": "9999-12-31T00:00:00.000Z"
                 },
                 "latest_request": {
                   "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                   "ip_address": "203.0.113.10"
                 },
                 "storage": {
-                  "cookies": true,
-                  "local_storage": true,
-                  "indexed_db": true,
-                  "service_worker": true,
-                  "window_name": true
+                  "cookies": false,
+                  "local_storage": false,
+                  "indexed_db": false,
+                  "service_worker": false,
+                  "window_name": false
                 },
                 "anchors": {
-                  "webgl_hash": "123456789",
-                  "parameters_hash": "-1234567890",
-                  "audio_hash": "1234567890"
+                  "webgl_hash": null,
+                  "parameters_hash": null,
+                  "audio_hash": null
                 }
               }
             },
@@ -14869,23 +15309,23 @@
                   "first_seen_at": "2026-03-01T18:22:11.000Z",
                   "last_seen_at": "2026-03-24T20:00:05.000Z",
                   "seen_count": 14,
-                  "expires_at": "2026-03-24T20:00:05.000Z"
+                  "expires_at": "9999-12-31T00:00:00.000Z"
                 },
                 "latest_request": {
                   "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                   "ip_address": "203.0.113.10"
                 },
                 "storage": {
-                  "cookies": true,
-                  "local_storage": true,
-                  "indexed_db": true,
-                  "service_worker": true,
-                  "window_name": true
+                  "cookies": false,
+                  "local_storage": false,
+                  "indexed_db": false,
+                  "service_worker": false,
+                  "window_name": false
                 },
                 "anchors": {
-                  "webgl_hash": "123456789",
-                  "parameters_hash": "-1234567890",
-                  "audio_hash": "1234567890"
+                  "webgl_hash": null,
+                  "parameters_hash": null,
+                  "audio_hash": null
                 }
               }
             ]
@@ -14914,23 +15354,23 @@
                 "first_seen_at": "2026-03-01T18:22:11.000Z",
                 "last_seen_at": "2026-03-24T20:00:05.000Z",
                 "seen_count": 14,
-                "expires_at": "2026-03-24T20:00:05.000Z"
+                "expires_at": "9999-12-31T00:00:00.000Z"
               },
               "latest_request": {
                 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                 "ip_address": "203.0.113.10"
               },
               "storage": {
-                "cookies": true,
-                "local_storage": true,
-                "indexed_db": true,
-                "service_worker": true,
-                "window_name": true
+                "cookies": false,
+                "local_storage": false,
+                "indexed_db": false,
+                "service_worker": false,
+                "window_name": false
               },
               "anchors": {
-                "webgl_hash": "123456789",
-                "parameters_hash": "-1234567890",
-                "audio_hash": "1234567890"
+                "webgl_hash": null,
+                "parameters_hash": null,
+                "audio_hash": null
               }
             }
           ],
@@ -14947,6 +15387,8 @@
       "VisitorFingerprintStorage": {
         "type": "object",
         "additionalProperties": false,
+        "deprecated": true,
+        "description": "Always `false` from `/v1/fingerprints`. The identity record behind this field spans both environments, so `/v1/fingerprints` cannot attribute it to your key's environment. Treat the flags as unavailable, not as evidence that a store was absent.",
         "required": [
           "cookies",
           "local_storage",
@@ -15010,7 +15452,7 @@
               "first_seen_at": "2026-03-01T18:22:11.000Z",
               "last_seen_at": "2026-03-24T20:00:05.000Z",
               "seen_count": 14,
-              "expires_at": "2026-03-24T20:00:05.000Z"
+              "expires_at": "9999-12-31T00:00:00.000Z"
             }
           },
           "latest_request": {
@@ -15033,9 +15475,9 @@
           "anchors": {
             "$ref": "#/components/schemas/VisitorFingerprintAnchors",
             "example": {
-              "webgl_hash": "123456789",
-              "parameters_hash": "-1234567890",
-              "audio_hash": "1234567890"
+              "webgl_hash": null,
+              "parameters_hash": null,
+              "audio_hash": null
             }
           }
         },
@@ -15046,23 +15488,23 @@
             "first_seen_at": "2026-03-01T18:22:11.000Z",
             "last_seen_at": "2026-03-24T20:00:05.000Z",
             "seen_count": 14,
-            "expires_at": "2026-03-24T20:00:05.000Z"
+            "expires_at": "9999-12-31T00:00:00.000Z"
           },
           "latest_request": {
             "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
             "ip_address": "203.0.113.10"
           },
           "storage": {
-            "cookies": true,
-            "local_storage": true,
-            "indexed_db": true,
-            "service_worker": true,
-            "window_name": true
+            "cookies": false,
+            "local_storage": false,
+            "indexed_db": false,
+            "service_worker": false,
+            "window_name": false
           },
           "anchors": {
-            "webgl_hash": "123456789",
-            "parameters_hash": "-1234567890",
-            "audio_hash": "1234567890"
+            "webgl_hash": null,
+            "parameters_hash": null,
+            "audio_hash": null
           }
         }
       },
@@ -15448,50 +15890,61 @@
                   },
                   "event": {
                     "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-                    "scoring_event_id": "scoring_event_id",
-                    "phase": "phase",
+                    "scoring_event_id": "1842",
+                    "phase": "behavioral",
                     "is_provisional": false,
                     "persisted_at": "2026-03-24T20:00:05.000Z"
                   },
                   "decision": {
-                    "verdict": "human",
+                    "verdict": "bot",
                     "risk_score": 94,
-                    "score": 0.08,
+                    "score": 0.94,
                     "manipulation": {
-                      "score": 1,
-                      "verdict": "none"
+                      "score": 18,
+                      "verdict": "low"
                     }
                   },
                   "visitor_fingerprint": {
                     "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
                   },
+                  "device_cluster": null,
                   "request": {
                     "url": "https://app.acme.co/signup",
                     "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                     "ip_address": "203.0.113.10",
                     "screen_size": "1440x900",
-                    "is_touch_capable": true,
+                    "is_touch_capable": false,
                     "platform": "macOS",
-                    "first_seen": "2026-03-01T18:22:11.000Z",
+                    "first_seen": "2026-03-24T19:59:58.000Z",
                     "risk_time": "2026-03-24T20:00:05.000Z"
                   },
                   "score_breakdown": {
                     "categories": {
-                      "source": "signup_form"
+                      "environment": 60,
+                      "fingerprint": 30,
+                      "keyboard": 10
                     }
                   },
                   "signals": [
                     {
-                      "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                      "id": "E1",
                       "category": "environment",
                       "confidence": "exact",
-                      "score": 0.08,
-                      "role": "owner"
+                      "score": 60,
+                      "role": "risk"
                     }
                   ],
                   "attribution": {
                     "bot": {
-                      "source": "signup_form"
+                      "labels": [
+                        {
+                          "kind": "actor",
+                          "value": "automation",
+                          "label": "Automation",
+                          "confidence": 97
+                        }
+                      ],
+                      "behaviors": []
                     }
                   }
                 }
@@ -15502,7 +15955,8 @@
                   "object": "webhook_test",
                   "endpoint": {
                     "id": "we_0123456789abcdef0123456789abcdef"
-                  }
+                  },
+                  "message": "This is a Foil webhook test event."
                 }
               }
             ],
@@ -15513,50 +15967,61 @@
               },
               "event": {
                 "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-                "scoring_event_id": "scoring_event_id",
-                "phase": "phase",
+                "scoring_event_id": "1842",
+                "phase": "behavioral",
                 "is_provisional": false,
                 "persisted_at": "2026-03-24T20:00:05.000Z"
               },
               "decision": {
-                "verdict": "human",
+                "verdict": "bot",
                 "risk_score": 94,
-                "score": 0.08,
+                "score": 0.94,
                 "manipulation": {
-                  "score": 1,
-                  "verdict": "none"
+                  "score": 18,
+                  "verdict": "low"
                 }
               },
               "visitor_fingerprint": {
                 "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
               },
+              "device_cluster": null,
               "request": {
                 "url": "https://app.acme.co/signup",
                 "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
                 "ip_address": "203.0.113.10",
                 "screen_size": "1440x900",
-                "is_touch_capable": true,
+                "is_touch_capable": false,
                 "platform": "macOS",
-                "first_seen": "2026-03-01T18:22:11.000Z",
+                "first_seen": "2026-03-24T19:59:58.000Z",
                 "risk_time": "2026-03-24T20:00:05.000Z"
               },
               "score_breakdown": {
                 "categories": {
-                  "source": "signup_form"
+                  "environment": 60,
+                  "fingerprint": 30,
+                  "keyboard": 10
                 }
               },
               "signals": [
                 {
-                  "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                  "id": "E1",
                   "category": "environment",
                   "confidence": "exact",
-                  "score": 0.08,
-                  "role": "owner"
+                  "score": 60,
+                  "role": "risk"
                 }
               ],
               "attribution": {
                 "bot": {
-                  "source": "signup_form"
+                  "labels": [
+                    {
+                      "kind": "actor",
+                      "value": "automation",
+                      "label": "Automation",
+                      "confidence": 97
+                    }
+                  ],
+                  "behaviors": []
                 }
               }
             }
@@ -15574,50 +16039,61 @@
             },
             "event": {
               "id": "evt_srwqc0yqhz4bxvtrdtf69q7vkr",
-              "scoring_event_id": "scoring_event_id",
-              "phase": "phase",
+              "scoring_event_id": "1842",
+              "phase": "behavioral",
               "is_provisional": false,
               "persisted_at": "2026-03-24T20:00:05.000Z"
             },
             "decision": {
-              "verdict": "human",
+              "verdict": "bot",
               "risk_score": 94,
-              "score": 0.08,
+              "score": 0.94,
               "manipulation": {
-                "score": 1,
-                "verdict": "none"
+                "score": 18,
+                "verdict": "low"
               }
             },
             "visitor_fingerprint": {
               "id": "vid_7cyvmdfjs3rzznf8m65v3bv51m"
             },
+            "device_cluster": null,
             "request": {
               "url": "https://app.acme.co/signup",
               "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
               "ip_address": "203.0.113.10",
               "screen_size": "1440x900",
-              "is_touch_capable": true,
+              "is_touch_capable": false,
               "platform": "macOS",
-              "first_seen": "2026-03-01T18:22:11.000Z",
+              "first_seen": "2026-03-24T19:59:58.000Z",
               "risk_time": "2026-03-24T20:00:05.000Z"
             },
             "score_breakdown": {
               "categories": {
-                "source": "signup_form"
+                "environment": 60,
+                "fingerprint": 30,
+                "keyboard": 10
               }
             },
             "signals": [
               {
-                "id": "sid_87wfetm98myh9awj0dpt28a3kc",
+                "id": "E1",
                 "category": "environment",
                 "confidence": "exact",
-                "score": 0.08,
-                "role": "owner"
+                "score": 60,
+                "role": "risk"
               }
             ],
             "attribution": {
               "bot": {
-                "source": "signup_form"
+                "labels": [
+                  {
+                    "kind": "actor",
+                    "value": "automation",
+                    "label": "Automation",
+                    "confidence": 97
+                  }
+                ],
+                "behaviors": []
               }
             }
           }
@@ -15800,10 +16276,11 @@
       },
       "WebhookTestEventPayload": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "required": [
           "object",
-          "endpoint"
+          "endpoint",
+          "message"
         ],
         "properties": {
           "object": {
@@ -15826,13 +16303,18 @@
             "example": {
               "id": "we_0123456789abcdef0123456789abcdef"
             }
+          },
+          "message": {
+            "type": "string",
+            "example": "This is a Foil webhook test event."
           }
         },
         "example": {
           "object": "webhook_test",
           "endpoint": {
             "id": "we_0123456789abcdef0123456789abcdef"
-          }
+          },
+          "message": "This is a Foil webhook test event."
         }
       },
       "WebhookTestResponse": {