@shotstack/cli 0.7.1 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -116,6 +116,31 @@ shotstack ingest delete <source-id> # remove a source from storag
116
116
 
117
117
  Sources are stored until you delete them. The bare `upload`/`fetch` commands return only an id — use `--watch` (or `ingest status`) to get the hosted URL once ingestion is `ready`.
118
118
 
119
+ ### `shotstack template <list|get|create|update|delete>`
120
+
121
+ Read and write templates saved to your Shotstack account. A template's content is just an Edit JSON (`timeline`, `output`, `merge`), so these round-trip with `render` and with templates you design in Studio.
122
+
123
+ ```sh
124
+ # List your saved templates (id and name), newest first
125
+ shotstack template list
126
+ shotstack template list --output json # full metadata (id, name, created, updated)
127
+
128
+ # Fetch a saved template's Edit JSON by id (output is the edit — pipes into render)
129
+ shotstack template get <id>
130
+ shotstack template get <id> > my-template.json && shotstack render my-template.json
131
+ shotstack template get <id> --env stage --output json # compact JSON on stdout
132
+
133
+ # Save a local edit as a new template; prints the new id
134
+ shotstack template create my-template.json --name "Promo v1"
135
+
136
+ # Overwrite a saved template (optionally rename it)
137
+ shotstack template update <id> my-template.json
138
+ shotstack template update <id> my-template.json --name "Promo v2"
139
+
140
+ # Delete a saved template
141
+ shotstack template delete <id>
142
+ ```
143
+
119
144
  ### `shotstack login` / `shotstack logout`
120
145
 
121
146
  Saves (or removes) your API key so it persists across shell sessions. Keys are stored per environment in `~/.shotstack/credentials.json`.