Modify a Transcoding Template

Modify an existing transcoding template with transcoding or transmuxing presets for an ingest domain, an app, or a stream

Request

Request-Line

Put /lls/v1.0/template/transcoding/{templateName}

Request

Path Parameters

Parameter	Type	Required	Description
templateName	String	Mandatory	transcoding template name

Request Body

Parameter	Type	Required	Description
domain	String	Mandatory	ingest domain name
app	String	Optional	app name. if not specified, the transcoding template will be applied to all apps.
stream	String	Optional	stream name. if not specified, the transcoding template will be applied to all streams.
deliveryProtocol	Array	Mandatory	delivery protocol. Valid values: http-flv, ll-hls, hls,dash.
transcodingPresets	Array	Mandatory	the names of transcoding presets for delivery stream. the special preset named 'transmux' will package the ingest stream without any transcoding.
status	String	Mandatory	Status of transcoding template. Valid values: active, inactive.

Response

Response Body

Parameter	Type	Required	Description
templateName	String	Mandatory	transcoding template name.
created	Timestamp	Mandatory	Timestamp of created time in UTC timezone. Default is now.
updated	Timestamp	Mandatory	Timestamp of updated time in UTC timezone. Default is now.
status	String	Mandatory	Status of transcoding template. Valid values: active, inactive.
domain	String	Mandatory	ingest domain name
app	String	Optional	app name. if not specified, the transcoding template will be applied to all apps.
stream	String	Optional	stream name. if not specified, the transcoding template will be applied to all streams.
deliveryProtocol	Array	Mandatory	delivery protocol. Valid values: http-flv, ll-hls, hls,dash.
transcodingPresets	Array	Mandatory	the names of transcoding presets for delivery stream. the special preset named 'transmux' will package the ingest stream without any transcoding.

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	LLS.TranscodingTemplate.InvalidName	Transcoding template name is invalid.
400	LLS.TranscodingTemplate.Conflict	Conflict transcoding emplate exists.

Examples

Modify a domain-level transcoding template with new protocols and presets

Request

PUT /lls/v1.0/template/transcoding/domainTemplate HTTP/1.1

{
  "domain": "ingest.example.com",
  "deliveryProtocol": ["ll-hls", "hls", "dash"],
  "transcodingPresets": ["720p", "480p", "360p"],
  "status": "active"
}

Successful Response Body

{
  "templateName": "domainTemplate",
  "created": "2025-07-15T08:47:10Z",
  "updated": "2025-07-15T10:05:04Z",
  "status": "active",
  "domain": "ingest.example.com",
  "deliveryProtocol": ["ll-hls", "hls", "dash"],
  "transcodingPresets": ["720p", "480p", "360p"]
}

Modify a domain-level transcoding template with new status

Request

PUT /lls/v1.0/template/transcoding/domainTemplate HTTP/1.1

{
  "domain": "ingest.example.com",
  "app": "live",
  "deliveryProtocol": ["http-flv", "ll-hls"],
  "transcodingPresets": ["1080p", "720p", "480p"],
  "status": "inactive"
}

Successful Response Body

{
  "templateName": "appTemplate",
  "created": "2025-07-15T08:48:30Z",
  "updated": "2025-07-15T10:05:04Z",
  "status": "active",
  "domain": "ingest.example.com",
  "app": "live",
  "deliveryProtocol": ["http-flv", "ll-hls"],
  "transcodingPresets": ["1080p", "720p", "480p"],
}

Best Practices

Rate Limiting

Rate Limits

Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:

• 100 requests per minute
• 1000 requests per hour