studio.snapshot_version
Name a studio project's version (the current one unless version is given) so it is never deleted by retention; naming a named version renames it. At most 20 named versions per project. Adds no new version, so an editor open on the project keeps saving. Refuses: a project_id outside your scope (NOT_FOUND): studio_project_list lists your projects; pass one of their ids; a label that is empty, over 80 characters or more than one line (SIMPLER_STUDIO_SNAPSHOT_LABEL_INVALID): send one line of 1 to 80 characters; 20 names already used (SIMPLER_STUDIO_SNAPSHOTS_FULL): remove one with studio.remove_snapshot; a project with no saved version (SIMPLER_STUDIO_SNAPSHOT_NOTHING_SAVED): save it first; a version the project no longer stores (SIMPLER_STUDIO_VERSION_NOT_STORED): call studio.list_versions and pick a listed one; an environment where names are not switched on yet (SIMPLER_STUDIO_SNAPSHOTS_UNAVAILABLE): saving and restoring still work; ask the owner to apply DB_MEDIA migration 0005. Free.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | The version's name, one line, for example "Approved by client". | |
| version | No | The version to name; the current version when left out. | |
| project_id | Yes | The studio project (vp_...) whose history to use. |