changelog: sdk v2

docs/changelog/overview.mdx

@@ -12,6 +12,17 @@ This page lists changes to Flare's API.
 Release notes for the Flare Platform can be found on the [product documentation website](https://docs.flare.io/releases).
 </Note>
 
+<Update label="2026-02-08" description="Python SDK - v2.0.0">
+  Released version 2.0.0 of the
+  [Python SDK <Icon icon="book" size={16} />](/sdk/python).
+
+  This release changes the API of `scroll_events` to yield `ScrollEventsResult` objects.
+  This new object exposes `metadata`, `event` and `next` fields.
+
+  The previous API for this method wouldn't expose the `metadata` and forced users of the library
+  to implement their own pagination logic.
+</Update>
+
 <Update label="2026-02" description="CLI - February 2026">
   Released the beta of the
   [Flare API CLI <Icon icon="book" size={16} />](/sdk/cli)

docs/sdk/python.mdx

@@ -120,7 +120,7 @@ from_timestamp: str = (
     datetime.datetime.now(tz=datetime.timezone.utc) - datetime.timedelta(hours=1)
 ).isoformat()
 
-for event, next_cursor in api_client.scroll_events(
+for result in api_client.scroll_events(
     method="POST",
     pages_url="/firework/v4/events/global/_search",
     events_url="/firework/v2/activities/",
@@ -138,8 +138,8 @@ for event, next_cursor in api_client.scroll_events(
         },
     },
 ):
-    print(f"Full event data: {event}")
-    print(f"The next execution could resume using from={next_cursor}")
+    print(f"Full event data: {result.event}")
+    print(f"The next execution could resume using from={result.next}")
 ```
 
 ## Custom Session

pyproject.toml

@@ -13,7 +13,7 @@ dependencies = [
     "requests>=2.32",
     "pytest>=8.4.2",
     "types-requests>=2.32",
-    "flareio>=1.2.0",
+    "flareio>=2.0.0",
 ]
 
 [build-system]