Skip to main content
A private template is a user-owned workflow authored with TemplateSpec. Each version is immutable; execution must bind to an explicit template_id and version_id.

​
Read the bundled contract

The installed CLI carries the matching English and Chinese TemplateSpec documentation:
The index reports spec and language revisions. Prefer these bundled documents over copied examples from another release.

​
Check, create, and version

Append an immutable version instead of editing history:
check is a local authoring validation step; the service can still reject an unavailable model or an environment-specific rule. create and create-version change remote state and require a separate, explicit confirmation when operated by an agent.

​
Topology rule: TS-TOPOLOGY-001

New templates, new versions, and Market publication cannot use bindMode=expanded in fieldBindings or paramBindings.
  • Use one workbook row per independently processed item.
  • For a fixed number of parallel branches, declare multiple explicit steps and connect them with dependsOn and upstreamBindings.
  • multiValue=true represents an ordered collection passed to a compatible input; it does not create dynamic executions.
  • TemplateSpec v1 does not support dynamic-cardinality step fan-out.
Historical versions that already use expanded execution remain compatible for execution. The restriction applies to new authoring and publication; do not rewrite historical versions in place.

​
Execute with a workbook

Download a new workbook when the template version changes. Compatibility with a workbook generated for another version is not promised.

​
Execute with JSONL

Never guess step IDs or substitute an inputAssetId for inputFileId. See Input assets for the distinction.