Skip to main content
Records are immutable or mutable data objects, depending on the stream template, that are stored in a stream. You create records by ingesting data into a stream. For a comprehensive guide on records, including detailed behavior, uniqueness constraints, and how they relate to streams, see About records and streams. Records have a similar shape to instances in the Data Modeling service, and their schema is defined by the containers referenced as sources. Each record also links to the space it belongs to, enabling space-based access control.
Every record has a required top-level externalId property, which you can use in some queries to retrieve or aggregate records.
  • Mutable records: The externalId and space properties uniquely identify records for write operations (create/upsert/delete).
  • Immutable records: The uniqueness of the space + externalId pair is not enforced, allowing multiple records with the same identifier to exist.

​
Rate and concurrency limits

For Records rate and concurrency limits, including mutable vs immutable stream budgets, see API rate limits.
Last modified on April 23, 2026