sdk: document scroll_events

Author: aviau

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="2025-05-15" description="Python SDK - v1.2.0">
+  Released version 1.2.0 of the
+  [Python SDK <Icon icon="book" size={16} />](/sdk/python).
+
+  This release adds a new `scroll_events` method that can be used to retrieve events from the feed APIs
+  without having to manage fetching events individually.
+  
+  More information, including full examples, can be found in the
+  [Python SDK documentation <Icon icon="book" size={16} />](/sdk/python).
+</Update>
+
 <Update label="2025-11" description="API - November 2025">
   Added a [Global Search Credentials Endpoint <Icon icon="code" size={16} />](/api-reference/v4/endpoints/credentials-global-search).
   This new endpoint allows for searching in all of Flare's credentials and counts towards the Global Search quota.

docs/sdk/python.mdx

@@ -58,12 +58,12 @@ resp = client.get("/tokens/test")
 print(resp.json())
 ```
 
-## Paging Util
+## Paging Util - Generic
 
 The `FlareApiClient` has a `scroll` method that can be used with endpoints that support the
 [Flare standard paging pattern <Icon icon="book" size={16} />](/concepts/paging).
 
-```python Paging Util Example
+```python Paging Util - Generic Example
 import os
 import time
 
@@ -102,6 +102,45 @@ for resp in api_client.scroll(
 print("The last value for 'next' was", last_from)
 ```
 
+## Paging Util - Event Feeds
+
+The `FlareApiClient` has a `scroll_events` method that can be used with event feeds endpoints.
+The advantage of this method over `scroll` is that it also automates the fetching of individual events.
+
+```python Paging Util - Event Feeds Example
+import datetime
+
+from flareio import FlareApiClient
+
+
+api_client = FlareApiClient.from_env()
+
+from_timestamp: str = (
+    datetime.datetime.now(tz=datetime.timezone.utc) - datetime.timedelta(hours=1)
+).isoformat()
+
+for event, next in api_client.scroll_events(
+    method="POST",
+    pages_url="/firework/v4/events/global/_search",
+    events_url="/firework/v2/activities/",
+    json={
+        "size": 10,
+        "order": "asc",
+        "from": None,
+        "filters": {
+            "type": ["chat_message"],
+            "estimated_created_at": {"gte": from_timestamp},
+        },
+        "query": {
+            "type": "query_string",
+            "query_string": "hello",
+        },
+    },
+):
+    print(f"Full event data: {event}")
+    print(f"The next execution could resume using from={next}")
+```
+
 ## Custom Session
 
 The `FlareApiClient` can be initialized with a custom `requests.Session`. This allows, for example,

requirements.txt

@@ -5,4 +5,4 @@ python-frontmatter==1.1.0
 requests==2.32.5
 pytest==8.4.2
 types-requests==2.32.4.20250913
-flareio>=1.1.0
+flareio>=1.2.0