Manage Templates

This page provides the basic commands for managing a template.

List templates

aenv template list        # alias: aenv template ls
aenv template list --output json

Displays all templates with their ID, name, build status, CPU, memory, disk size, and last-updated timestamp. --output accepts table or json. It defaults to table in an interactive terminal and json when output is piped or redirected.

List template builds

List the complete build history for one template:

curl -H 'X-API-Key: test-key' \
  http://127.0.0.1:8000/templates/<template-id>

Check a template alias

Check whether an alias exists and resolve it to a template ID:

curl -H 'X-API-Key: test-key' \
  http://127.0.0.1:8000/templates/aliases/<alias>

Delete a template

aenv template delete <template-id-or-name>   # alias: aenv template rm

Once a delete starts, the template stops resolving and its name can be reused right away. If the delete fails partway, run it again by ID to remove what is left.