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

v2.7.1 - fix versioning bug

What's Changed

• Fix version numbering by @maxkahan in #215

Full Changelog: v2.7.0...v2.7.1

v2.7.0 - send frame stats to SFU

What's Changed

• Send frame info to SFU by @maxkahan in #214

Full Changelog: v2.6.0...v2.7.0

v2.6.0 - send webRTC stats to SFU

What's Changed

• Send webRTC stats to SFU by @maxkahan in #213

Full Changelog: v2.5.22...v2.6.0

v2.5.22

What's Changed

• TY linting (replaces mypi) by @tschellenbach in #210
• Fix event loop warnings by @dangusev in #212

Full Changelog: 2.5.21...v2.5.22

v2.5.21 - Make torch optional for webrtc

Merge pull request #209 from GetStream/notorch

remove pytorch from main dep

2.5.20 - Appeal endpoints

What's Changed

• Fix codegen and update readme by @tbarbugli in #208

Full Changelog: 2.5.19...2.5.20

2.5.19 - G711/ulaw

What's Changed

• Added PyAVResampler - a stateful resampler implementation by @dangusev in #206
• Add support for G711 audio by @tbarbugli in #202
• Fix create_user at Stream and AsyncStream by @dangusev in #207

Full Changelog: 2.5.18...2.5.19