From 619526bd545043761ea8fec222e929ad9a9c6e03 Mon Sep 17 00:00:00 2001
From: "fingerprint-dx-team-actions-runner[bot]"
 <197604345+fingerprint-dx-team-actions-runner[bot]@users.noreply.github.com>
Date: Thu, 22 Oct 2026 08:46:06 +0000
Subject: [PATCH] chore: sync OpenAPI schema

---
 schemas/paths/event.yaml                             | 12 ++++++++++--
 .../errors/400_edge_event_not_updatable.json         |  6 ++++++
 schemas/paths/examples/errors/400_event_too_old.json |  6 ++++++
 3 files changed, 22 insertions(+), 2 deletions(-)
 create mode 100644 schemas/paths/examples/errors/400_edge_event_not_updatable.json
 create mode 100644 schemas/paths/examples/errors/400_event_too_old.json

diff --git a/schemas/paths/event.yaml b/schemas/paths/event.yaml
index bfdd6b85..303e4344 100644
--- a/schemas/paths/event.yaml
+++ b/schemas/paths/event.yaml
@@ -131,7 +131,9 @@ patch:
     When an event is created, it can be assigned `linked_id` and `tags` submitted through the JS agent parameters. 
     This information might not have been available on the client initially, so the Server API permits updating these attributes after the fact.
 
-    **Warning** It's not possible to update events older than one month. 
+    **Warning** You can only update events created within the last 10 days. Updating an older event returns HTTP 400 with the message `event is too old to be updated (> 10 days)`, even if your plan retains events for longer.
+
+    **Warning** Events created by the Automation Intelligence API (`POST /edge`) cannot be updated. Updating them returns HTTP 400.
 
     **Warning** Trying to update an event immediately after creation may temporarily result in an 
     error (HTTP 409 Conflict. The event is not mutable yet.) as the event is fully propagated across our systems. In such a case, simply retry the request.
@@ -154,7 +156,7 @@ patch:
     '200':
       description: OK.
     '400':
-      description: Bad request. The request payload is not valid.
+      description: Bad request. The request payload is not valid, the event is older than 10 days, or the event cannot be updated.
       content:
         application/json:
           schema:
@@ -163,6 +165,12 @@ patch:
             example:
               summary: Error response when the specified request payload is not valid and cannot be parsed.
               externalValue: examples/errors/400_request_body_invalid.json
+            400-event-too-old:
+              summary: Error response when the event was created more than 10 days ago.
+              externalValue: examples/errors/400_event_too_old.json
+            400-edge-event-not-updatable:
+              summary: Error response when the event was created by the Automation Intelligence API and cannot be updated.
+              externalValue: examples/errors/400_edge_event_not_updatable.json
     '403':
       description: Forbidden. Access to this API is denied.
       content:
diff --git a/schemas/paths/examples/errors/400_edge_event_not_updatable.json b/schemas/paths/examples/errors/400_edge_event_not_updatable.json
new file mode 100644
index 00000000..a74f678a
--- /dev/null
+++ b/schemas/paths/examples/errors/400_edge_event_not_updatable.json
@@ -0,0 +1,6 @@
+{
+  "error": {
+    "code": "failed",
+    "message": "edge events cannot be updated"
+  }
+}
diff --git a/schemas/paths/examples/errors/400_event_too_old.json b/schemas/paths/examples/errors/400_event_too_old.json
new file mode 100644
index 00000000..b6fdc58d
--- /dev/null
+++ b/schemas/paths/examples/errors/400_event_too_old.json
@@ -0,0 +1,6 @@
+{
+  "error": {
+    "code": "failed",
+    "message": "event is too old to be updated (> 10 days)"
+  }
+}