Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions pages/reference/api/create-stream.en-US.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down