diff --git a/pages/reference/api/create-stream.en-US.mdx b/pages/reference/api/create-stream.en-US.mdx
index 3cc4ee16b..5ee224fde 100644
--- a/pages/reference/api/create-stream.en-US.mdx
+++ b/pages/reference/api/create-stream.en-US.mdx
@@ -2,11 +2,22 @@
 title: POST Create stream
 ---
 
+import { Callout } from 'nextra-theme-docs';
+
 # `POST` Create a stream
 
 `POST /stream` creates a `stream` object. The configuration on this parent
 `stream` object is inherited by all future child `session` objects.
 
+It is important to note, that the stream object is the core building block of the Livepeer Studio platform.
+In Livepeer Studio, the stream object has unique configuration data and metadata about all livestream sessions that are associated with the stream.
+
+<Callout>
+  Historically, a stream object with a `parentId` represented a single
+  livestream session. This type of "child-session" stream object will be
+  deprecated in an upcoming version of the API in favor of the session object.
+</Callout>
+
 The only parameter you are required to set is the `name` of your stream, but we
 also highly recommend that you define the `profiles` parameter with 720p, 480p
 and 360p renditions.