v3.2.0

What's Changed

• Allow custom HTTP transport and client configuration in #235

Users can now pass a custom transport (for connection pool limits, retries, HTTP/2) or a pre-built http_client to Stream / AsyncStream:

import httpx
from getstream import Stream

transport = httpx.HTTPTransport(
    limits=httpx.Limits(max_connections=100, max_keepalive_connections=20),
    retries=3,
)
client = Stream(api_key="...", api_secret="...", transport=transport)

When custom config is provided, all sub-clients (video, chat, moderation, feeds) share a single HTTP client for efficient connection pooling.

Full Changelog: v3.1.2...v3.2.0

v3.1.2

What's Changed

• Exit early when trying to close the peer connections twice by @dangusev in #234

Full Changelog: v3.1.1...v3.1.2

v3.1.1

What's Changed

• Stop drain_proxy on subscriber arrival to prevent relay queue leak by @aliev in #233

Full Changelog: v3.1.0...v3.1.1

v3.1.0

What's Changed

• [CHA-2563] Add retention policy integration tests by @hifaizsk in #227
• [FEEDS-1206]fix file uploads by @itsmeadi in #223
• fix: stop video drain when real subscriber arrives by @aliev in #232

New Contributors

• @hifaizsk made their first contribution in #227

Full Changelog: v3.0.4...v3.1.0

v3.0.4

What's Changed

• feat: configurable video frame buffering with blackhole drain by @aliev in #231

Full Changelog: v3.0.3...v3.0.4

v3.0.3

What's Changed

• fix: close child httpx clients in AsyncStream.aclose() by @aliev in #230

Full Changelog: v3.0.2...v3.0.3

v3.0.2

What's Changed

• chore: align ci titles and group tests by @mogita in #225
• Pin ty@0.0.24 to fix CI typecheck by @aliev in #229
• Fix audio buffer memory leak: use in-place del instead of slice-copy by @aliev in #228

Full Changelog: v3.0.1...v3.0.2

v3.0.1

What's Changed

• [CHA-2585] feat: add migration guide from stream-chat-python by @mogita in #220
• Remove the usage of the forked aiortc-getstream lib by @dangusev in #221
• Retry connect() on SFU full by requesting a different SFU by @aliev in #222
• [CHA-2716] Ignore null fields by @mogita in #224

New Contributors

• @aliev made their first contribution in #222

Full Changelog: v3.0.0...v3.0.1

3.0.0

[3.0.0] - 2026-03-25

Installation

  pip install "getstream>=3,<4"
  # or
  uv add "getstream>=3,<4"

https://pypi.org/project/getstream/

Breaking Changes

• Type names across all products now follow the OpenAPI spec naming convention: response types are suffixed with Response, input types with Request. See MIGRATION_v2_to_v3.md for the complete rename mapping.
• Event (WebSocket envelope type) renamed to WSEvent. Base event type renamed from BaseEvent to Event (with field type instead of T).
• Event composition changed from monolithic *Preset embeds to modular Has* types.
• Pager renamed to PagerResponse and migrated from offset-based to cursor-based pagination (next/prev tokens).
• Types that were previously dict or TypedDict (e.g., User, Channel, Message) are now full dataclasses with typed fields.

Added

• Full product coverage: Chat, Video, Moderation, and Feeds APIs are all supported in a single SDK.
• Feeds: activities, feeds, feed groups, follows, comments, reactions, collections, bookmarks, membership levels, feed views, and more.
• Video: calls, recordings, transcription, closed captions, SFU, call statistics, user feedback analytics, and more.
• Moderation: flags, review queue, moderation rules, config, appeals, moderation logs, and more.
• Push notification types, preferences, and templates.
• Webhook support: WHEvent envelope class for receiving webhook payloads, utility functions for decoding and verifying webhook signatures, and a full set of individual typed event dataclasses for every event across all products (Chat, Video, Moderation, Feeds) usable as discriminated event types.
• Cursor-based pagination across all list endpoints.

PR

• [CHA-1578] refactor: code generated from openapi specs by @mogita in #205

Full Changelog: v2.7.1...v3.0.0

v3.0.0b1

[3.0.0b1] - 2026-02-27

Installation

pip install getstream==3.0.0b1
# or
uv add getstream==3.0.0b1

Breaking Changes

• Type names across all products now follow the OpenAPI spec naming convention: response types are suffixed with Response, input types with Request. See MIGRATION_v2_to_v3.md for the complete rename mapping.
• Event (WebSocket envelope type) renamed to WSEvent. Base event type renamed from BaseEvent to Event (with field type instead of T).
• Event composition changed from monolithic *Preset embeds to modular Has* types.
• Pager renamed to PagerResponse and migrated from offset-based to cursor-based pagination (next/prev tokens).
• Types that were previously dict or TypedDict (e.g., User, Channel, Message) are now full dataclasses with typed fields.

Added

• Full product coverage: Chat, Video, Moderation, and Feeds APIs are all supported in a single SDK.
• Feeds: activities, feeds, feed groups, follows, comments, reactions, collections, bookmarks, membership levels, feed views, and more.
• Video: calls, recordings, transcription, closed captions, SFU, call statistics, user feedback analytics, and more.
• Moderation: flags, review queue, moderation rules, config, appeals, moderation logs, and more.
• Push notification types, preferences, and templates.
• Webhook support: WHEvent envelope class for receiving webhook payloads, utility functions for decoding and verifying webhook signatures, and a full set of individual typed event dataclasses for every event across all products (Chat, Video, Moderation, Feeds) usable as discriminated event types.
• Cursor-based pagination across all list endpoints.

Full Changelog: v2.7.1...v3.0.0b1