Actions
Actions
Query the training exercises catalog and manage custom actions owned by the current user. Each action has a numeric actionId used in session templates and workout data. No device connection required.
| Command | Options | Notes |
|---|---|---|
voltra actions list | [--type-id <id>] [--name <query>] [--api-key <key>] [--json] | List all actions. Filter by body part (--type-id) or name substring (--name, case-insensitive). |
voltra actions types | [--api-key <key>] [--json] | List action types (body parts). |
voltra actions groups | [--api-key <key>] [--json] | List actions grouped by body part. |
voltra actions get <id> | [--api-key <key>] [--json] | Look up a single action by its numeric ID. |
voltra actions create | --name <name> [--type-id <id>] [--api-key <key>] [--json] | Create a custom action. --type-id defaults to Functional (10). |
voltra actions update <id> | --name <name> [--type-id <id>] [--api-key <key>] [--json] | Update a custom action owned by the current user. Omitting --type-id resets it to Functional (10). |
voltra actions delete <id> | --yes [--api-key <key>] [--json] | Delete a custom action. Requires confirmation because referenced workout history is reset to the default action list. |
voltra actions list
voltra actions list --type-id 33
voltra actions list --name bench
voltra --json actions types
voltra --json actions groups
voltra actions get 33Create a custom action
Names must contain 1–50 characters with no leading or trailing whitespace. Custom action names must be unique within the current account.
voltra actions create --name "Bench Press" --type-id 4
voltra --json actions create --name "Cable Rotation"If --type-id is omitted, or is outside 1..=10, the action uses Functional (10). An account can have up to 200 custom actions.
Update a custom action
Only custom actions owned by the current account can be updated. The update command always requires the complete new name. To rename an action without changing its body part, look up its current typeId and pass it explicitly:
voltra --json actions get 1024
voltra actions update 1024 --name "Incline Bench Press" --type-id 4If --type-id is omitted, the type is reset to Functional (10).
Delete a custom action
Only custom actions owned by the current account can be deleted. Deletion requires --yes:
voltra actions delete 1024 --yesDeleting a custom action also causes workout history that referenced it to use the default action list. Confirm this consequence before deleting. Built-in actions cannot be updated or deleted.
Successful create, update, and delete commands invalidate the local action catalog cache, so the next actions list, groups, or get request fetches current server data.
Common action type IDs: 1=Whole Body, 2=Legs, 3=Back, 4=Chest, 5=Shoulders, 6=Biceps, 7=Triceps, 8=Core, 9=Forearms, 10=Functional. Default action: actionId=33 (Free Exercises).