Skip to main content
POST

Overview

Saves an existing stream’s configuration under a name, so the same setup can be recreated later without rebuilding the payload. The template stores no configuration of its own: applying it with Use a Stream Template replays the referenced stream’s original creation payload. The stream_id must belong to a stream created in your workspace. Template names are unique per workspace, and each workspace can hold at most 20 templates; a duplicate name or a full workspace returns 409.

Authorizations

x-api-key
string
header
required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Body

application/json
name
string
required

The template's name, unique within the workspace.

Required string length: 1 - 100
stream_id
integer
required

The id of a created stream in your workspace whose configuration the template saves.

Response

The created template.

id
integer
required

The template id.

name
string
required

The template's name, unique within the workspace.

stream_id
integer
required

The stream this template was saved from.

Last modified on August 7, 2026