From 566269a7c11f707ff32293f2a06d14f21f8a9b89 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 9 Oct 2026 11:27:02 +0000 Subject: [PATCH 1/6] fix: remove v3 deprecation dates from Server API schemas 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 Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu --- ...-related-visitors-api-readme-explorer.yaml | 23 +++-- schemas/fingerprint-server-api-for-sdks.yaml | 88 +++++++++++++------ ...ingerprint-server-api-readme-explorer.yaml | 79 +++++++++++------ 3 files changed, 130 insertions(+), 60 deletions(-) diff --git a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml index a45ec1f7..4ce9a239 100644 --- a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml +++ b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml @@ -6,13 +6,16 @@ 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 + > This version of the API will **soon be deprecated** under our [API Deprecation - Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If - you still use this version, please follow our [migration + Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). The + deprecation period will begin once all proxy and library integrations (both + backend and frontend) are released. We will continue to provide full support + for 12 months from that effective date. This notice will be updated with the + **official deprecation date once it is set**. If you don’t use libraries or + proxy integrations, you can use this [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 **start the transition to the new API today**. Use this API to unify and personalize the experience for your anonymous @@ -48,10 +51,14 @@ 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 + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. The API will be fully removed after the deprecation period ends. Related visitors API lets you link web visits and in-app browser visits diff --git a/schemas/fingerprint-server-api-for-sdks.yaml b/schemas/fingerprint-server-api-for-sdks.yaml index e8153d51..747c3c07 100644 --- a/schemas/fingerprint-server-api-for-sdks.yaml +++ b/schemas/fingerprint-server-api-for-sdks.yaml @@ -6,12 +6,16 @@ info: > - > This version of Server API is marked as deprecated starting on **Jan 7th - 2026** according to our [API Deprecation - Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If - you still use this version, please follow our [migration + > This version of the API will **soon be deprecated** under our [API + Deprecation + Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). The + deprecation period will begin once all proxy and library integrations (both + backend and frontend) are released. We will continue to provide full support + for 12 months from that effective date. This notice will be updated with the + **official deprecation date once it is set**. If you don’t use libraries or + proxy integrations, you can use this [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 **start the transition to the new API today**. Fingerprint Server API allows you to search, update, and delete @@ -58,12 +62,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Get a detailed analysis of an individual identification event, including @@ -673,12 +682,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Change information in existing events specified by `requestId` or *flag @@ -793,12 +807,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Search for identification events, including Smart Signals, using @@ -1701,12 +1720,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. This endpoint is deprecated. Use `GET /events/search` to query visit @@ -1962,12 +1986,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Request deleting all data associated with the specified visitor ID. This @@ -2155,9 +2184,14 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. The API will be fully removed after the deprecation period ends. Related visitors API lets you link web visits and in-app browser visits diff --git a/schemas/fingerprint-server-api-readme-explorer.yaml b/schemas/fingerprint-server-api-readme-explorer.yaml index ef2e978a..42967a12 100644 --- a/schemas/fingerprint-server-api-readme-explorer.yaml +++ b/schemas/fingerprint-server-api-readme-explorer.yaml @@ -6,12 +6,16 @@ info: > - > This version of Server API is marked as deprecated starting on **Jan 7th - 2026** according to our [API Deprecation - Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). If - you still use this version, please follow our [migration + > This version of the API will **soon be deprecated** under our [API + Deprecation + Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). The + deprecation period will begin once all proxy and library integrations (both + backend and frontend) are released. We will continue to provide full support + for 12 months from that effective date. This notice will be updated with the + **official deprecation date once it is set**. If you don’t use libraries or + proxy integrations, you can use this [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 **start the transition to the new API today**. Fingerprint Server API allows you to search, update, and delete @@ -66,12 +70,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Get a detailed analysis of an individual identification event, including @@ -843,12 +852,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Change information in existing events specified by `requestId` or *flag @@ -1211,12 +1225,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Search for identification events, including Smart Signals, using @@ -2285,12 +2304,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. This endpoint is deprecated. Use `GET /events/search` to query visit @@ -2709,12 +2733,17 @@ paths: > - > This version of Server API is marked as deprecated starting on **Jan - 7th 2026** according to our [API Deprecation + > This version of the API will **soon be deprecated** under our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - If you still use this version, please follow our [migration + The deprecation period will begin once all proxy and library + integrations (both backend and frontend) are released. We will continue + to provide full support for 12 months from that effective date. This + notice will be updated with the **official deprecation date once it is + set**. If you don’t use libraries or proxy integrations, you can use + this [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 **start the transition to the new API today**. Request deleting all data associated with the specified visitor ID. This From 71ae25a958315a27604f541f1b60bb7f1dd60b53 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 9 Oct 2026 11:48:14 +0000 Subject: [PATCH 2/6] fix: set v3 deprecation date to October 31, 2027 Replace the "soon be deprecated" notice with the new date. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu --- ...-related-visitors-api-readme-explorer.yaml | 23 ++--- schemas/fingerprint-server-api-for-sdks.yaml | 88 ++++++------------- ...ingerprint-server-api-readme-explorer.yaml | 79 ++++++----------- 3 files changed, 59 insertions(+), 131 deletions(-) diff --git a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml index 4ce9a239..2e6d64c8 100644 --- a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml +++ b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml @@ -6,16 +6,12 @@ info: > - > This version of the API will **soon be deprecated** under our [API - Deprecation - Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). The - deprecation period will begin once all proxy and library integrations (both - backend and frontend) are released. We will continue to provide full support - for 12 months from that effective date. This notice will be updated with the - **official deprecation date once it is set**. If you don’t use libraries or - proxy integrations, you can use this [migration + > This version of Server API will be deprecated on **October 31, 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 **start the transition to the new API today**. + to migrate to the new one. Use this API to unify and personalize the experience for your anonymous @@ -51,14 +47,9 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. The API will be fully removed after the deprecation period ends. Related visitors API lets you link web visits and in-app browser visits diff --git a/schemas/fingerprint-server-api-for-sdks.yaml b/schemas/fingerprint-server-api-for-sdks.yaml index 747c3c07..6f37730c 100644 --- a/schemas/fingerprint-server-api-for-sdks.yaml +++ b/schemas/fingerprint-server-api-for-sdks.yaml @@ -6,16 +6,12 @@ info: > - > This version of the API will **soon be deprecated** under our [API - Deprecation - Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). The - deprecation period will begin once all proxy and library integrations (both - backend and frontend) are released. We will continue to provide full support - for 12 months from that effective date. This notice will be updated with the - **official deprecation date once it is set**. If you don’t use libraries or - proxy integrations, you can use this [migration + > This version of Server API will be deprecated on **October 31, 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 **start the transition to the new API today**. + to migrate to the new one. Fingerprint Server API allows you to search, update, and delete @@ -62,17 +58,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events) - to **start the transition to the new API today**. + to migrate to the new one. Get a detailed analysis of an individual identification event, including @@ -682,17 +673,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-update-/events) - to **start the transition to the new API today**. + to migrate to the new one. Change information in existing events specified by `requestId` or *flag @@ -807,17 +793,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events/search) - to **start the transition to the new API today**. + to migrate to the new one. Search for identification events, including Smart Signals, using @@ -1720,17 +1701,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/visitors) - to **start the transition to the new API today**. + to migrate to the new one. This endpoint is deprecated. Use `GET /events/search` to query visit @@ -1986,17 +1962,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4) - to **start the transition to the new API today**. + to migrate to the new one. Request deleting all data associated with the specified visitor ID. This @@ -2184,14 +2155,9 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. The API will be fully removed after the deprecation period ends. Related visitors API lets you link web visits and in-app browser visits diff --git a/schemas/fingerprint-server-api-readme-explorer.yaml b/schemas/fingerprint-server-api-readme-explorer.yaml index 42967a12..c42eed32 100644 --- a/schemas/fingerprint-server-api-readme-explorer.yaml +++ b/schemas/fingerprint-server-api-readme-explorer.yaml @@ -6,16 +6,12 @@ info: > - > This version of the API will **soon be deprecated** under our [API - Deprecation - Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). The - deprecation period will begin once all proxy and library integrations (both - backend and frontend) are released. We will continue to provide full support - for 12 months from that effective date. This notice will be updated with the - **official deprecation date once it is set**. If you don’t use libraries or - proxy integrations, you can use this [migration + > This version of Server API will be deprecated on **October 31, 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 **start the transition to the new API today**. + to migrate to the new one. Fingerprint Server API allows you to search, update, and delete @@ -70,17 +66,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events) - to **start the transition to the new API today**. + to migrate to the new one. Get a detailed analysis of an individual identification event, including @@ -852,17 +843,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-update-/events) - to **start the transition to the new API today**. + to migrate to the new one. Change information in existing events specified by `requestId` or *flag @@ -1225,17 +1211,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/events/search) - to **start the transition to the new API today**. + to migrate to the new one. Search for identification events, including Smart Signals, using @@ -2304,17 +2285,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4#migrating-get-/visitors) - to **start the transition to the new API today**. + to migrate to the new one. This endpoint is deprecated. Use `GET /events/search` to query visit @@ -2733,17 +2709,12 @@ paths: > - > This version of the API will **soon be deprecated** under our [API - Deprecation + > This version of Server API will be deprecated on **October 31, 2027** + according to our [API Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). - The deprecation period will begin once all proxy and library - integrations (both backend and frontend) are released. We will continue - to provide full support for 12 months from that effective date. This - notice will be updated with the **official deprecation date once it is - set**. If you don’t use libraries or proxy integrations, you can use - this [migration + If you still use this version, please follow our [migration guide](https://docs.fingerprint.com/reference/migrating-from-server-api-v3-to-v4) - to **start the transition to the new API today**. + to migrate to the new one. Request deleting all data associated with the specified visitor ID. This From 568e1a84f99c5710d7173b53a7a1fddeccb2f6aa Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 9 Oct 2026 11:49:54 +0000 Subject: [PATCH 3/6] fix: use October 31, 2026 deprecation and October 31, 2027 end date v3 becomes deprecated on October 31, 2026 and stops working on October 31, 2027. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu --- ...-related-visitors-api-readme-explorer.yaml | 9 ++--- schemas/fingerprint-server-api-for-sdks.yaml | 34 +++++++++++-------- ...ingerprint-server-api-readme-explorer.yaml | 29 +++++++++------- 3 files changed, 42 insertions(+), 30 deletions(-) diff --git a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml index 2e6d64c8..8261114d 100644 --- a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml +++ b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml @@ -6,8 +6,8 @@ info: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** and + will stop working on **October 31, 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) @@ -47,8 +47,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 2027** according to our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). diff --git a/schemas/fingerprint-server-api-for-sdks.yaml b/schemas/fingerprint-server-api-for-sdks.yaml index 6f37730c..c68e5fa7 100644 --- a/schemas/fingerprint-server-api-for-sdks.yaml +++ b/schemas/fingerprint-server-api-for-sdks.yaml @@ -6,8 +6,8 @@ info: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** and + will stop working on **October 31, 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) @@ -58,8 +58,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-get-/events) @@ -673,8 +674,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-update-/events) @@ -793,8 +795,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-get-/events/search) @@ -1701,8 +1704,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-get-/visitors) @@ -1962,8 +1966,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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) @@ -2155,8 +2160,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 2027** according to our [API + Deprecation Policy](https://docs.fingerprint.com/reference/api-deprecation-policy). diff --git a/schemas/fingerprint-server-api-readme-explorer.yaml b/schemas/fingerprint-server-api-readme-explorer.yaml index c42eed32..f2c0f4b7 100644 --- a/schemas/fingerprint-server-api-readme-explorer.yaml +++ b/schemas/fingerprint-server-api-readme-explorer.yaml @@ -6,8 +6,8 @@ info: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** and + will stop working on **October 31, 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) @@ -66,8 +66,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-get-/events) @@ -843,8 +844,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-update-/events) @@ -1211,8 +1213,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-get-/events/search) @@ -2285,8 +2288,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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#migrating-get-/visitors) @@ -2709,8 +2713,9 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2027** - according to our [API Deprecation + > This version of Server API will be deprecated on **October 31, 2026** + and will stop working on **October 31, 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) From fbad9896a4f66c3a22177d759332f933d156b1cf Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 9 Oct 2026 13:24:57 +0000 Subject: [PATCH 4/6] fix: align v3 deprecation notices with docs wording 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 Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu --- ...-related-visitors-api-readme-explorer.yaml | 16 +++-- schemas/fingerprint-server-api-for-sdks.yaml | 59 +++++++++---------- ...ingerprint-server-api-readme-explorer.yaml | 53 ++++++++--------- 3 files changed, 58 insertions(+), 70 deletions(-) diff --git a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml index 8261114d..046b91d9 100644 --- a/schemas/fingerprint-related-visitors-api-readme-explorer.yaml +++ b/schemas/fingerprint-related-visitors-api-readme-explorer.yaml @@ -6,12 +6,10 @@ info: > - > This version of Server API will be deprecated on **October 31, 2026** and - will stop working on **October 31, 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 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 @@ -47,10 +45,10 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 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 diff --git a/schemas/fingerprint-server-api-for-sdks.yaml b/schemas/fingerprint-server-api-for-sdks.yaml index c68e5fa7..a2e4b7b5 100644 --- a/schemas/fingerprint-server-api-for-sdks.yaml +++ b/schemas/fingerprint-server-api-for-sdks.yaml @@ -6,12 +6,12 @@ info: > - > This version of Server API will be deprecated on **October 31, 2026** and - will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Fingerprint Server API allows you to search, update, and delete @@ -58,13 +58,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Get a detailed analysis of an individual identification event, including @@ -674,13 +673,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Change information in existing events specified by `requestId` or *flag @@ -795,13 +793,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Search for identification events, including Smart Signals, using @@ -1704,13 +1701,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. This endpoint is deprecated. Use `GET /events/search` to query visit @@ -1966,13 +1962,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Request deleting all data associated with the specified visitor ID. This @@ -2160,10 +2155,10 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 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 diff --git a/schemas/fingerprint-server-api-readme-explorer.yaml b/schemas/fingerprint-server-api-readme-explorer.yaml index f2c0f4b7..c36407e9 100644 --- a/schemas/fingerprint-server-api-readme-explorer.yaml +++ b/schemas/fingerprint-server-api-readme-explorer.yaml @@ -6,12 +6,12 @@ info: > - > This version of Server API will be deprecated on **October 31, 2026** and - will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Fingerprint Server API allows you to search, update, and delete @@ -66,13 +66,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Get a detailed analysis of an individual identification event, including @@ -844,13 +843,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Change information in existing events specified by `requestId` or *flag @@ -1213,13 +1211,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Search for identification events, including Smart Signals, using @@ -2288,13 +2285,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. This endpoint is deprecated. Use `GET /events/search` to query visit @@ -2713,13 +2709,12 @@ paths: > - > This version of Server API will be deprecated on **October 31, 2026** - and will stop working on **October 31, 2027** 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 to the new one. + to move to v4 before that date. Request deleting all data associated with the specified visitor ID. This From d620a455677201ac831455f72438c1ea3c333c86 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Oct 2026 10:15:41 +0000 Subject: [PATCH 5/6] chore: add changeset for v3 deprecation dates Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu --- .changeset/v3-deprecation-dates.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/v3-deprecation-dates.md diff --git a/.changeset/v3-deprecation-dates.md b/.changeset/v3-deprecation-dates.md new file mode 100644 index 00000000..69e61533 --- /dev/null +++ b/.changeset/v3-deprecation-dates.md @@ -0,0 +1,5 @@ +--- +'openapi': patch +--- + +**v3**: Set the deprecation date to October 31, 2026 and the end-of-life date to October 31, 2027 in the endpoint descriptions From 4b042c96b996767beb12dd81246a3329a519870f Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Oct 2026 10:16:36 +0000 Subject: [PATCH 6/6] chore: drop invalid scope from v3 deprecation changeset Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01S6AuB1xNKrrrmVKPX5vExu --- .changeset/v3-deprecation-dates.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.changeset/v3-deprecation-dates.md b/.changeset/v3-deprecation-dates.md index 69e61533..fc35b999 100644 --- a/.changeset/v3-deprecation-dates.md +++ b/.changeset/v3-deprecation-dates.md @@ -2,4 +2,4 @@ 'openapi': patch --- -**v3**: Set the deprecation date to October 31, 2026 and the end-of-life date to October 31, 2027 in the endpoint descriptions +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