milesoft template

Retrieve details, compile configuration, and list/manage liquid templates.

milesoft template list

Retrieve a paginated collection of liquid templates currently active in the ecosystem.

• Usage: milesoft template list [flags]

Examples

List Templates in Tabular format (TTY Layout)

$ milesoft template list
==================================================================================================
TEMPLATE ID          NAME                                CREATED             UPDATED
==================================================================================================
list-tmpl-1          Welcome Email                       2026-07-16 12:00:00 N/A
list-tmpl-2          Receipt Layout                      2026-07-16 12:05:00 2026-07-16 13:00:00
==================================================================================================
End of collection (limit 50)

List Templates with Limit and Cursor

milesoft template list --limit 10 --cursor "next-page-cursor"

List Templates as Indented JSON (Pipes & Scripts)

milesoft template list --json

milesoft template get

Retrieve the full details of a specific liquid template by its ID.

• Usage: milesoft template get <template-id> [flags]

Examples

Retrieve Template details (TTY Layout)

$ milesoft template get temp-001
=========================================================================
             Template
=========================================================================
ID:            temp-001
Name:          Welcome Email
Order:         1
-------------------------------------------------------------------------
Content:
Hello {{ user.name }}, welcome!
-------------------------------------------------------------------------
Created:       2026-07-16T12:00:00Z
Updated:       2026-07-16T12:00:00Z
=========================================================================

Retrieve Template with Extra and Metadata properties

$ milesoft template get temp-002
=========================================================================
             Template
=========================================================================
ID:            temp-002
Name:          Rich Template
Order:         2
-------------------------------------------------------------------------
Metadata:
  audit_id = 9988
  source = cli
-------------------------------------------------------------------------
Content:
Total: {{ amount }}
-------------------------------------------------------------------------
Extra:
  category = receipt
  channel = email
-------------------------------------------------------------------------
Created:       2026-07-16T12:05:00Z
Updated:       2026-07-16T13:00:00Z
=========================================================================

Extract a Single Field Value (Piping Content to file)

milesoft template get temp-001 --field content > template.html

Extract New Template ID dynamically for Automation Pipelines

NEW_ID=$(milesoft template get temp-001 --field id)

Retrieve Template as Indented JSON

milesoft template get temp-001 --json

milesoft template create

Create a new liquid template with name, content, order, and optional metadata/extra configurations.

• Usage: milesoft template create [flags]
• Sub-flags:
  • --content string (Required): Liquid string content.
  • --name string (Required): Name of the template.
  • --extra string: JSON map for extra client fields (e.g., '{"key":"value"}').
  • --metadata string: JSON map for metadata audit fields (e.g., '{"key":"value"}').
  • --order int: Sequence execution order.

Examples

Basic Template Creation

$ milesoft template create --name "Welcome Email" --content "Hello {{ user.name }}, welcome!" --order 1
=========================================================================
             Created Template
=========================================================================
Template ID: new-tmpl-101
Name:        Welcome Email
Order:       1
Content:     Hello {{ user.name }}, welcome!
Created:     2026-07-17T15:00:00Z
=========================================================================

Creating Template with JSON Metadata and Extra Fields

$ milesoft template create --name "Transactional Receipt" --content "Total: {{ amount }}" --extra '{"category":"receipt","channel":"email"}' --metadata '{"audit_id":9988}'
=========================================================================
             Created Template
=========================================================================
Template ID: new-tmpl-102
Name:        Transactional Receipt
Order:       0
Content:     Total: {{ amount }}
Extra:       {"category":"receipt","channel":"email"}
Metadata:    {"audit_id":9988}
Created:     2026-07-17T15:10:00Z
=========================================================================

Create Template and Output JSON Schema

milesoft template create --name "Alert" --content "Error: {{ msg }}" --json

milesoft template update

Perform a surgical partial update of one or more properties on a template. At least one flag must be provided to execute an update.

• Usage: milesoft template update <template-id> [flags]
• Sub-flags:
  • --content string: New liquid string content.
  • --name string: New name of the template.
  • --extra string: New JSON map for extra client fields (e.g., '{"key":"value"}').
  • --metadata string: New JSON map for metadata audit fields (e.g., '{"key":"value"}').
  • --order int: New sequence execution order.

Examples

Update Template Content

$ milesoft template update temp-001 --content "Hello {{ user.name }}, welcome back!"
=========================================================================
             Updated Template
=========================================================================
Template ID: temp-001
Name:        Welcome Email
Order:       1
Content:     Hello {{ user.name }}, welcome back!
Updated:     2026-07-17T15:30:00Z
=========================================================================

Update Multiple Properties (Name, Order, and Metadata JSON map)

$ milesoft template update temp-001 --name "Updated Welcome Email" --order 5 --metadata '{"updated_by":"admin"}'
=========================================================================
             Updated Template
=========================================================================
Template ID: temp-001
Name:        Updated Welcome Email
Order:       5
Content:     Hello {{ user.name }}, welcome back!
Metadata:    {"updated_by":"admin"}
Updated:     2026-07-17T15:35:00Z
=========================================================================

milesoft template copy

Create a perfect, un-linked duplicate of a specified template in the ecosystem.

• Usage: milesoft template copy <template-id> [flags]

Examples

Copying/Cloning a Template

$ milesoft template copy temp-001
=========================================================================
             Copied Template
=========================================================================
New Template ID: temp-001-copy-7766
Name:            Welcome Email Copy
Order:           1
Content:         Hello {{ user.name }}, welcome!
Created:         2026-07-17T15:40:00Z
=========================================================================

Copying a Template and Extracting its New ID for Pipelines

NEW_ID=$(milesoft template copy temp-001 --field id)

Copying a Template and Outputting JSON Schema

milesoft template copy temp-001 --json

milesoft template delete

Remove a liquid template permanently from the library repository.

• Usage: milesoft template delete <template-id> [flags]

Examples

Deleting Interactively

$ milesoft template delete temp-001
Are you sure you want to delete template temp-001? (y/N): y
Success! Template temp-001 has been deleted.

Interactive Delete Cancellation

$ milesoft template delete temp-001
Are you sure you want to delete template temp-001? (y/N): n
Delete cancelled.

###### Bypassing Prompts for Automation (Auto-Approve/Force Delete)
```text
$ milesoft template delete temp-001 --yes
Success! Template temp-001 has been deleted.