Versioning

Every factory is associated with a specific version of the Transform transcoding engine. Version identifiers have the following format:

YYYY-MM-NNN

• YYYY is the year of the engine release.
• MM is the month of the release.
• NNN is the release number. Release numbers are assigned sequentially within a month starting at 001.

Use the following command to get a full list of the production versions:

curl -H 'X-Api-Key: tcs_YOUR_API_KEY' https://api.cloud.telestream.net/transform/v1.0/engine-versions

The command returns an array of version identifiers in chronological order as shown below:

[
  "2021-03-001",
  "2021-03-002"
]

Specify the engine_version property when creating a new factory, for example:

curl -L -X POST 'https://api.cloud.telestream.net/transform/v1.0/factories' \
--header 'X-Api-Key: tcs_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
   "name":"factory123",
   "output_store_id":"YOUR_STORE_ID",
   "engine_version":"2021-03-002"
}'

If engine_version is not specified the factory will always use the latest available version.

Use the following command to change the engine version on an existing factory:

curl -L -X PUT 'https://api.cloud.telestream.net/transform/v1.0/factories/FACTORY_ID' \
--header 'X-Api-Key: tcs_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
   "name":"factory123",
   "output_store_id":"YOUR_STORE_ID",
   "engine_version":"2021-04-001"
}'