In the snapshot ZIP file, any directories with names starting with '@' have special meaning. They define the structure of the snapshot file.
The part of the directory tree of the snapshot zip file related to tags has the following structure:
@tags/ directory
Located in a top-level zip file directory and contains the tag content.
There are two subdirectories of the @tags/ directories:
Except for these two subdirectories, the @tags/ directory is not supposed to contain any other files or directories.
@access/ directory
Located under @tags directory contains files with definitions of tags with access control.
@basic/ directory
Located under @tags directory contains files with definitions of tags without access control.
The content of the tag definition file is in the Toml configuration file format. At this moment only optional tag's description attribute is available. File example:
A tag's definition file might be empty.
A tag's definition file should have the .tag extension. The base file name (file without extension) is interpreted as tag's name. For example, a file MY_TAG.tag describes "MY_TAG" tag in Hyperon.
File with tag's definition is encoded using UTF-8.
To export tags in Hyperon Studio, go to Tools → Snapshot Export, check tag checkbox, you do NOT need to choose profiles from which tags should be exported, because Tags are not assigned to any profile. Just click the Export button and the export popup will appear. When the export is finished and no errors occurred, click the Download button to download snapshot in the zip file. If any error during export happens, an error message will be shown and the Download button will be unavailable to click.
Endpoint path, method, response statuses are available here: REST export endpoint
To export tags via REST, the section below must be present in a REST request