v1

latestSwagger 2.02026-07-1745100168.1 KB

templates

Create or update template

post/templates/{code}

Path parameters

codestring required

Template code

Request body

codestring

Code is the unique key chosen by the operator.

descriptionstring

namestring

Name and Description are template-level metadata. Name surfaces in the API for human-readable lists; Description carries the rationale behind the template's settings. Streams inheriting this template keep their own Name / Description fields — the template metadata is for operator-facing tooling, not for downstream consumers.

playback_policystring

PlaybackPolicy is the media-auth Policy code inherited by streams referencing this template (see domain.Policy). Empty = no policy (inheriting streams stay public unless they set their own).

prefixesstring[]

Prefixes is the list of URL-path prefixes that trigger auto-publish. When an encoder pushes to a path whose first segment(s) match any prefix here AND this template has at least one publish:// input, a runtime stream is created on the fly. Prefixes must not overlap any other template's prefix (validated at save time).

stream_keystring

StreamKey is the shared push-authentication secret for streams that inherit this template. Empty means no secret is templated and each stream may set its own (or none).

tagsstring[]

Tags propagate to inheriting streams when the stream leaves Tags empty. Useful for grouping every stream that follows a common profile under one operational label.

Response

object required