Records and Streams support in the Cognite Python SDK (alpha)

Hi everyone,

The Cognite Python SDK now supports Records and Streams, from cognite-sdk 8.12.0.

Records give you high volume storage for structured data such as logs, events, tabular data, without overloading your knowledge graph. Streams control retention, mutability and throughput for that data. If Records is new to you, start here: https://docs.cognite.com/cdf/dm/records/concepts/records_and_streams

What is included

Both APIs are fully covered:

• Streams: create, list, retrieve, delete
• Records: ingest, upsert, filter, sync, sync_resume, aggregate, delete

This is an alpha release

The feature is not generally available. The SDK raises a FeaturePreviewWarning when you use it, and we may make breaking changes to the SDK without notice while we improve the ergonomics. Use it in development and test projects, not in production pipelines.

We will keep it in alpha until early to mid September, before deciding on the next step. That time is there so you can test it and tell us what should change.

Getting started

pip install --upgrade cognite-sdk
# or
uv add cognite-sdk

from cognite.client import AsyncCogniteClient
from cognite.client.data_classes.data_modeling.records import TimeRange

client = AsyncCogniteClient()

records = await client.data_modeling.records.filter(
    stream_id="historic_alarms",
    last_updated_time=TimeRange(gte="2026-08-01T00:00:00Z"),
    limit=100,
)

Reference docs:

• Streams: https://cognite-sdk-python.readthedocs-hosted.com/en/latest/data_modeling/streams.html
• Records: https://cognite-sdk-python.readthedocs-hosted.com/en/latest/data_modeling/records.html 

What we would like feedback on

• Naming and method signatures. Does anything read wrong or work differently from how you expected?
• Data classes such as RecordWrite, RecordSource and TimeRange. Are they convenient to build and inspect?
• Error messages. Did anything fail in a way that did not tell you what to fix?
• Gaps. Is anything missing for what you are building?

Comment on this post to share your feedback.