Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JuroUhlar merged 6 commits into from
Oct 15, 2026
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
566269a
fix: remove v3 deprecation dates from Server API schemas
claude Oct 9, 2026
71ae25a
fix: set v3 deprecation date to October 31, 2027
claude Oct 9, 2026
568e1a8
fix: use October 31, 2026 deprecation and October 31, 2027 end date
claude Oct 9, 2026
fbad989
fix: align v3 deprecation notices with docs wording
claude Oct 9, 2026
d620a45
chore: add changeset for v3 deprecation dates
claude Oct 15, 2026
4b042c9
chore: drop invalid scope from v3 deprecation changeset
claude Oct 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/v3-deprecation-dates.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'openapi': patch
---

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
17 changes: 7 additions & 10 deletions schemas/fingerprint-related-visitors-api-readme-explorer.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,10 @@ info:

>

> 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
Expand Down Expand Up @@ -48,10 +45,10 @@ paths:

>

> 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
Expand Down
53 changes: 27 additions & 26 deletions schemas/fingerprint-server-api-for-sdks.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,12 @@ info:

>

> 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
Comment thread
JuroUhlar marked this conversation as resolved.
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
Expand Down Expand Up @@ -58,12 +58,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -673,12 +673,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -793,12 +793,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -1701,12 +1701,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -1962,12 +1962,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -2155,9 +2155,10 @@ paths:

>

> 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
Expand Down
48 changes: 24 additions & 24 deletions schemas/fingerprint-server-api-readme-explorer.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,12 @@ info:

>

> 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
Expand Down Expand Up @@ -66,12 +66,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -843,12 +843,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -1211,12 +1211,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -2285,12 +2285,12 @@ paths:

>

> 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
Expand Down Expand Up @@ -2709,12 +2709,12 @@ paths:

>

> 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
Expand Down
Loading