INTER-2648: fix: set v3 Server API deprecation to Oct 31, 2026 and end of life to Oct 31, 2027 by JuroUhlar · Pull Request #491 · fingerprintjs/openapi

JuroUhlar · 2026-10-09T11:27:13Z

The v3 schemas say Server API v3 is deprecated "starting on Jan 7th 2026" (and Related Visitors "fully defunct on Jan 7th 2027"). These dates are not correct.

Per Product, v3 is deprecated as of October 31, 2026 and stops working on October 31, 2027. The notices now use the same wording as the docs (fingerprintjs/docs#547):

Server API v3 is deprecated as of October 31, 2026, and stops working on October 31, 2027, according to the API Deprecation Policy. If you still use v3, follow the migration guide to move to v4 before that date.

Related Visitors notices:

The Related Visitors API is deprecated as of October 31, 2026, and stops working on October 31, 2027, according to the API Deprecation Policy. It has no direct replacement in Server API v4.

Migration guide links keep their per-endpoint anchors.

Changed: all 15 notices in fingerprint-server-api-for-sdks.yaml, fingerprint-server-api-readme-explorer.yaml and fingerprint-related-visitors-api-readme-explorer.yaml. Description text only.

Checks: pnpm build, lintSchema, lintSchemaDist, test, typecheck pass.

Related: fingerprintjs/docs#545 switches the v3 docs pages to the synced schema.

🤖 Generated with Claude Code

https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

Restore the deprecation notice wording used on docs.fingerprint.com: the API will soon be deprecated and the official date will be set later. The Jan 7th 2026 / Jan 7th 2027 dates were not correct. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

changeset-bot · 2026-10-09T11:27:17Z

🦋 Changeset detected

Latest commit: 4b042c9

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
openapi	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-10-09T11:27:47Z

Schema Diff vs Published Schemas

Generated at: 2026-10-15T10:17:12.692Z
Published source: https://fingerprintjs.github.io/openapi/schemas
Compared schemas: 8
Changed schemas: 5

`fingerprint-related-visitors-api-readme-explorer.yaml`

Published URL: https://fingerprintjs.github.io/openapi/schemas/fingerprint-related-visitors-api-readme-explorer.yaml
Summary: +0 added, -0 removed, ~2 modified

Added elements (0)

None

Removed elements (0)

None

Modified elements (2)

/info/description
/paths/~1related-visitors/get/description

Changed lines patch

--- a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml
+++ b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml
@@ -4,17 +4,14 @@
   description: >
     > 🚧 Deprecation Notice
 
     >
 
-    > This version of Server API is marked as deprecated starting on **Jan 7th
-    2026** and will be fully defunct on **Jan 7th 2027** according to our [API
-    Deprecation
-    Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If
-    you still use this version, please follow our [migration
-    guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-    to migrate from this deprecated version to the new one.
+    > The Related Visitors API is deprecated as of **October 31, 2026**, and
+    stops working on **October 31, 2027**, according to the [API Deprecation
+    Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). It
+    has no direct replacement in Server API v4.
 
 
     Use this API to unify and personalize the experience for your anonymous
     users who visit your website from regular and in-app browsers.
   version: '1.0'
@@ -46,14 +43,14 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** and will be fully removed on **Jan 7th 2027** according to
-        our [API Deprecation
+        > The Related Visitors API is deprecated as of **October 31, 2026**, and
+        stops working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
+        It has no direct replacement in Server API v4.
 
 
         Related visitors API lets you link web visits and in-app browser visits
         that originated from the same mobile device.

`fingerprint-server-api-compact.yaml`

Published URL: https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api-compact.yaml
Summary: +0 added, -0 removed, ~7 modified

Added elements (0)

None

Removed elements (0)

None

Modified elements (7)

/info/description
/paths/~1events~1search/get/description
/paths/~1events~1{request_id}/get/description
/paths/~1events~1{request_id}/put/description
/paths/~1related-visitors/get/description
/paths/~1visitors~1{visitor_id}/delete/description
/paths/~1visitors~1{visitor_id}/get/description

Changed lines patch

--- a/schemas/fingerprint-server-api-compact.yaml
+++ b/schemas/fingerprint-server-api-compact.yaml
@@ -4,16 +4,16 @@
   description: >
     > 🚧 Deprecation Notice
 
     >
 
-    > This version of Server API is marked as deprecated starting on **Jan 7th
-    2026** according to our [API Deprecation
+    > Server API v3 is deprecated as of **October 31, 2026**, and stops working
+    on **October 31, 2027**, according to the [API Deprecation
     Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If
-    you still use this version, please follow our [migration
+    you still use v3, follow the [migration
     guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-    to migrate from this deprecated version to the new one.
+    to move to v4 before that date.
 
 
     Fingerprint Server API allows you to search, update, and delete
     identification events in a server environment. It can be used for data
     exports, decision-making, and data analysis scenarios.
@@ -55,16 +55,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Get a detailed analysis of an individual identification event, including
         Smart Signals. 
 
@@ -135,16 +135,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-update-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Change information in existing events specified by `requestId` or *flag
         suspicious events*.
 
@@ -209,16 +209,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events/search)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Search for identification events, including Smart Signals, using
         multiple filtering criteria. If you don't provide `start` or `end`
         parameters, the default search range is the last 7 days.
@@ -737,16 +737,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/visitors)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         This endpoint is deprecated. Use `GET /events/search` to query visit
         history or filter across multiple events.
 
@@ -909,16 +909,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Request deleting all data associated with the specified visitor ID. This
         API is useful for compliance with privacy regulations.
 
@@ -1024,13 +1024,14 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > The Related Visitors API is deprecated as of **October 31, 2026**, and
+        stops working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
+        It has no direct replacement in Server API v4.
 
 
         Related visitors API lets you link web visits and in-app browser visits
         that originated from the same mobile device.

`fingerprint-server-api-readme-explorer.yaml`

Published URL: https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api-readme-explorer.yaml
Summary: +0 added, -0 removed, ~6 modified

Added elements (0)

None

Removed elements (0)

None

Modified elements (6)

/info/description
/paths/~1events~1search/get/description
/paths/~1events~1{request_id}/get/description
/paths/~1events~1{request_id}/put/description
/paths/~1visitors~1{visitor_id}/delete/description
/paths/~1visitors~1{visitor_id}/get/description

Changed lines patch

--- a/schemas/fingerprint-server-api-readme-explorer.yaml
+++ b/schemas/fingerprint-server-api-readme-explorer.yaml
@@ -4,16 +4,16 @@
   description: >
     > 🚧 Deprecation Notice
 
     >
 
-    > This version of Server API is marked as deprecated starting on **Jan 7th
-    2026** according to our [API Deprecation
+    > Server API v3 is deprecated as of **October 31, 2026**, and stops working
+    on **October 31, 2027**, according to the [API Deprecation
     Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If
-    you still use this version, please follow our [migration
+    you still use v3, follow the [migration
     guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-    to migrate from this deprecated version to the new one.
+    to move to v4 before that date.
 
 
     Fingerprint Server API allows you to search, update, and delete
     identification events in a server environment. It can be used for data
     exports, decision-making, and data analysis scenarios.
@@ -64,16 +64,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Get a detailed analysis of an individual identification event, including
         Smart Signals. 
 
@@ -846,16 +846,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-update-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Change information in existing events specified by `requestId` or *flag
         suspicious events*.
 
@@ -1214,16 +1214,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events/search)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Search for identification events, including Smart Signals, using
         multiple filtering criteria. If you don't provide `start` or `end`
         parameters, the default search range is the last 7 days.
@@ -2293,16 +2293,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/visitors)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         This endpoint is deprecated. Use `GET /events/search` to query visit
         history or filter across multiple events.
 
@@ -2722,16 +2722,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Request deleting all data associated with the specified visitor ID. This
         API is useful for compliance with privacy regulations.

`fingerprint-server-api-schema-for-sdks.yaml`

Published URL: https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api-schema-for-sdks.yaml
Summary: +0 added, -0 removed, ~7 modified

Added elements (0)

None

Removed elements (0)

None

Modified elements (7)

/info/description
/paths/~1events~1search/get/description
/paths/~1events~1{request_id}/get/description
/paths/~1events~1{request_id}/put/description
/paths/~1related-visitors/get/description
/paths/~1visitors~1{visitor_id}/delete/description
/paths/~1visitors~1{visitor_id}/get/description

Changed lines patch

--- a/schemas/fingerprint-server-api-schema-for-sdks.yaml
+++ b/schemas/fingerprint-server-api-schema-for-sdks.yaml
@@ -4,16 +4,16 @@
   description: >
     > 🚧 Deprecation Notice
 
     >
 
-    > This version of Server API is marked as deprecated starting on **Jan 7th
-    2026** according to our [API Deprecation
+    > Server API v3 is deprecated as of **October 31, 2026**, and stops working
+    on **October 31, 2027**, according to the [API Deprecation
     Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If
-    you still use this version, please follow our [migration
+    you still use v3, follow the [migration
     guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-    to migrate from this deprecated version to the new one.
+    to move to v4 before that date.
 
 
     Fingerprint Server API allows you to search, update, and delete
     identification events in a server environment. It can be used for data
     exports, decision-making, and data analysis scenarios.
@@ -55,16 +55,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Get a detailed analysis of an individual identification event, including
         Smart Signals. 
 
@@ -135,16 +135,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-update-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Change information in existing events specified by `requestId` or *flag
         suspicious events*.
 
@@ -209,16 +209,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events/search)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Search for identification events, including Smart Signals, using
         multiple filtering criteria. If you don't provide `start` or `end`
         parameters, the default search range is the last 7 days.
@@ -737,16 +737,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/visitors)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         This endpoint is deprecated. Use `GET /events/search` to query visit
         history or filter across multiple events.
 
@@ -909,16 +909,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Request deleting all data associated with the specified visitor ID. This
         API is useful for compliance with privacy regulations.
 
@@ -1024,13 +1024,14 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > The Related Visitors API is deprecated as of **October 31, 2026**, and
+        stops working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
+        It has no direct replacement in Server API v4.
 
 
         Related visitors API lets you link web visits and in-app browser visits
         that originated from the same mobile device.

`fingerprint-server-api.yaml`

Published URL: https://fingerprintjs.github.io/openapi/schemas/fingerprint-server-api.yaml
Summary: +0 added, -0 removed, ~7 modified

Added elements (0)

None

Removed elements (0)

None

Modified elements (7)

/info/description
/paths/~1events~1search/get/description
/paths/~1events~1{request_id}/get/description
/paths/~1events~1{request_id}/put/description
/paths/~1related-visitors/get/description
/paths/~1visitors~1{visitor_id}/delete/description
/paths/~1visitors~1{visitor_id}/get/description

Changed lines patch

--- a/schemas/fingerprint-server-api.yaml
+++ b/schemas/fingerprint-server-api.yaml
@@ -4,16 +4,16 @@
   description: >
     > 🚧 Deprecation Notice
 
     >
 
-    > This version of Server API is marked as deprecated starting on **Jan 7th
-    2026** according to our [API Deprecation
+    > Server API v3 is deprecated as of **October 31, 2026**, and stops working
+    on **October 31, 2027**, according to the [API Deprecation
     Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If
-    you still use this version, please follow our [migration
+    you still use v3, follow the [migration
     guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-    to migrate from this deprecated version to the new one.
+    to move to v4 before that date.
 
 
     Fingerprint Server API allows you to search, update, and delete
     identification events in a server environment. It can be used for data
     exports, decision-making, and data analysis scenarios.
@@ -55,16 +55,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Get a detailed analysis of an individual identification event, including
         Smart Signals. 
 
@@ -675,16 +675,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-update-/events)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Change information in existing events specified by `requestId` or *flag
         suspicious events*.
 
@@ -795,16 +795,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events/search)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Search for identification events, including Smart Signals, using
         multiple filtering criteria. If you don't provide `start` or `end`
         parameters, the default search range is the last 7 days.
@@ -1708,16 +1708,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/visitors)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         This endpoint is deprecated. Use `GET /events/search` to query visit
         history or filter across multiple events.
 
@@ -1974,16 +1974,16 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > Server API v3 is deprecated as of **October 31, 2026**, and stops
+        working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
-        If you still use this version, please follow our [migration
+        If you still use v3, follow the [migration
         guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4)
-        to migrate from this deprecated version to the new one.
+        to move to v4 before that date.
 
 
         Request deleting all data associated with the specified visitor ID. This
         API is useful for compliance with privacy regulations.
 
@@ -2167,13 +2167,14 @@
       description: >
         > 🚧 Deprecation Notice
 
         >
 
-        > This version of Server API is marked as deprecated starting on **Jan
-        7th 2026** according to our [API Deprecation
+        > The Related Visitors API is deprecated as of **October 31, 2026**, and
+        stops working on **October 31, 2027**, according to the [API Deprecation
         Policy](https://docs.fingerprint.com/reference/api-deprecation-policy).
+        It has no direct replacement in Server API v4.
 
 
         Related visitors API lets you link web visits and in-app browser visits
         that originated from the same mobile device.

Replace the "soon be deprecated" notice with the new date. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

v3 becomes deprecated on October 31, 2026 and stops working on October 31, 2027. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

Use the same wording as the docs v3 deprecation notices (fingerprintjs/docs#547). Related Visitors notices say the API has no direct replacement in Server API v4. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

Copilot

🟡 Changes recommended

A required changeset is missing, preventing the corrected timeline from reaching release notes.

1 open finding

Add changeset for schema deprecation timeline updates · New

What changed in this PR

Updates legacy v3 schema notices with the corrected deprecation and end-of-life dates.

Changes:

Sets deprecation to October 31, 2026 and shutdown to October 31, 2027.
Clarifies that Related Visitors has no direct v4 replacement.

File	Description
`schemas/fingerprint-server-api-readme-explorer.yaml`	Updates v3 explorer notices.
`schemas/fingerprint-server-api-for-sdks.yaml`	Updates SDK-facing notices.
`schemas/fingerprint-related-visitors-api-readme-explorer.yaml`	Updates Related Visitors notices.

🧠 Review effort: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

github-actions · 2026-10-15T10:17:15Z

🚀 Following releases will be created using changesets from this PR:

openapi@3.9.1

Patch Changes

Set the Server API v3 deprecation date to October 31, 2026 and the end-of-life date to October 31, 2027 in the endpoint descriptions (d620a45)

JuroUhlar deployed to test October 9, 2026 11:27 — with GitHub Actions Active

JuroUhlar marked this pull request as ready for review October 9, 2026 11:31

JuroUhlar requested a review from a team as a code owner October 9, 2026 11:31

JuroUhlar requested a review from ilfa October 9, 2026 11:31

fix: set v3 deprecation date to October 31, 2027

71ae25a

Replace the "soon be deprecated" notice with the new date. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

JuroUhlar deployed to test October 9, 2026 11:48 — with GitHub Actions Active

JuroUhlar changed the title ~~fix: remove v3 deprecation dates from Server API schemas~~ fix: set v3 Server API deprecation date to October 31, 2027 Oct 9, 2026

fix: use October 31, 2026 deprecation and October 31, 2027 end date

568e1a8

v3 becomes deprecated on October 31, 2026 and stops working on October 31, 2027. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

JuroUhlar deployed to test October 9, 2026 11:50 — with GitHub Actions Active

JuroUhlar changed the title ~~fix: set v3 Server API deprecation date to October 31, 2027~~ fix: set v3 Server API deprecation to Oct 31, 2026 and end of life to Oct 31, 2027 Oct 9, 2026

JuroUhlar deployed to test October 9, 2026 13:25 — with GitHub Actions Active

JuroUhlar changed the title ~~fix: set v3 Server API deprecation to Oct 31, 2026 and end of life to Oct 31, 2027~~ INTER-2648: fix: set v3 Server API deprecation to Oct 31, 2026 and end of life to Oct 31, 2027 Oct 10, 2026

JuroUhlar requested a balanced review from Copilot October 13, 2026 01:30

Copilot started reviewing on behalf of JuroUhlar October 13, 2026 01:31

View session

Copilot AI reviewed Oct 13, 2026

View reviewed changes

Comment thread schemas/fingerprint-server-api-for-sdks.yaml

chore: add changeset for v3 deprecation dates

d620a45

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

JuroUhlar deployed to test October 15, 2026 10:15 — with GitHub Actions Active

chore: drop invalid scope from v3 deprecation changeset

4b042c9

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu

JuroUhlar deployed to test October 15, 2026 10:16 — with GitHub Actions Active

TheUnderScorer approved these changes Oct 15, 2026

View reviewed changes

JuroUhlar merged commit 9790b00 into main Oct 15, 2026
7 checks passed

JuroUhlar deleted the fix/v3-deprecation-notice branch October 15, 2026 10:21

Navigation Menu

Repository navigation

INTER-2648: fix: set v3 Server API deprecation to Oct 31, 2026 and end of life to Oct 31, 2027 - #491

INTER-2648: fix: set v3 Server API deprecation to Oct 31, 2026 and end of life to Oct 31, 2027#491
JuroUhlar merged 6 commits into
mainfrom
fix/v3-deprecation-notice

JuroUhlar commented Oct 9, 2026 •

edited by atlassian Bot

Loading

Uh oh!

changeset-bot Bot commented Oct 9, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 9, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

github-actions Bot commented Oct 15, 2026

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

JuroUhlar commented Oct 9, 2026 • edited by atlassian Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions Bot commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Schema Diff vs Published Schemas

fingerprint-related-visitors-api-readme-explorer.yaml

fingerprint-server-api-compact.yaml

fingerprint-server-api-readme-explorer.yaml

fingerprint-server-api-schema-for-sdks.yaml

fingerprint-server-api.yaml

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

github-actions Bot commented Oct 15, 2026

🚀 Following releases will be created using changesets from this PR:

openapi@3.9.1

Patch Changes

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

JuroUhlar commented Oct 9, 2026 •

edited by atlassian Bot

Loading

changeset-bot Bot commented Oct 9, 2026 •

edited

Loading

github-actions Bot commented Oct 9, 2026 •

edited

Loading

`fingerprint-related-visitors-api-readme-explorer.yaml`

`fingerprint-server-api-compact.yaml`

`fingerprint-server-api-readme-explorer.yaml`

`fingerprint-server-api-schema-for-sdks.yaml`

`fingerprint-server-api.yaml`