// Step Templates

Update a step template

Update a step template's name, script, properties, or run modes.

PUT/api/step-template

Description

Updates a step template. Pass only the fields to change. Existing project steps using this template keep their current property values until the next edit.

Parameters

NameInTypeRequiredDescription
stepTemplateId body string yes ID of the step template.
name body string no New name.
description body string no New description.
supportedRunModes body array<string> no See below.
script body string no New script body.
scriptLanguage body string no New script language.
propertiesRaw body string no New JSON-encoded property definitions.

Supported run modes

Each supportedRunModes entry must be TargetMachine, Worker, or WorkerToCloudTargets. Values that cannot be parsed are ignored; if no valid entries remain, the request returns 400.

Errors

StatusMeaning
400 Invalid stepTemplateId or validation failure.
401 Missing or invalid Basic auth credentials, or the service account lacks the required role.