Skip to content

metalcloud-cli template-asset create

Create a new template asset from configuration

Create a new template asset using a configuration file or piped input.

Required Flags: —config-source: Source of the template asset configuration (required) Can be ‘pipe’ for piped input or path to a JSON file

Configuration Format: The configuration must be in JSON format with the following structure: { “templateId”: 123, // Required: ID of the OS template “usage”: “logo”, // Required: Usage type (logo, icon, build_source_image, etc.) “file”: { // Required: File configuration “name”: “example.png”, // Required: File name “mimeType”: “image/png”, // Required: MIME type “checksum”: “sha256-hash”, // Optional: File checksum “contentBase64”: “base64-content”, // Optional: Base64 encoded file content “templatingEngine”: false, // Optional: Enable templating (default: false) “url”: “https://example.com/file.png” // Optional: External URL }, “tags”: [“branding”, “image”] // Optional: Tags for categorization }

Examples:

metalcloud-cli template-asset create —config-source asset-config.json

echo ’{“templateId”: 123, “usage”: “logo”, “file”: {“name”: “logo.png”, “mimeType”: “image/png”}}’ | metalcloud-cli template-asset create —config-source pipe

metalcloud-cli template-asset config-example > config.json

metalcloud-cli template-asset create —config-source config.json

metalcloud-cli template-asset create [flags]
--config-source string Source of the new template asset configuration. Can be 'pipe' or path to a JSON file.
-h, --help help for create
-k, --api_key string MetalCloud API key
-c, --config string Config file path
-d, --debug Set to enable debug logging
-e, --endpoint string MetalCloud API endpoint
-f, --format string Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
-i, --insecure_skip_verify Set to allow insecure transport
-l, --log_file string Log file path
-v, --verbosity string Log level verbosity (default "INFO")

Auto generated by spf13/cobra on 11-Aug-2025

Section titled “Auto generated by spf13/cobra on 11-Aug-2025”