Cortex References
Sessions
Sessions
Manage training session templates via the Cloud API. All session commands require a VOLTRA API key. No device connection required.
The CLI only supports managing session templates — it does not execute session training. To follow a template's exercise sequence for actual training, use the Beyond+ App (iOS only).
Session Management
| Command | Options | Notes |
|---|---|---|
voltra session list | [--api-key <key>] [--json] | List all session templates for the account. |
voltra session detail <id> | [--api-key <key>] [--json] | Show full details of a single session template by numeric ID. |
voltra session create | --from <path> [--api-key <key>] [--json] | Create a new session from a JSON file (SessionCreateRequest). Fields: title, accountRole, label, sessionConfig, blockList, connectionMode. Optional: originSessionId (usually omitted). Do not include groupIdList — the backend v2 create DTO ignores it. |
voltra session update <id> | --from <path> [--api-key <key>] [--json] | Update a session from a JSON file (SessionUpdateRequest). Only four fields: title, sessionConfig, blockList, connectionMode. Other fields (accountRole, label, originSessionId, blockId, itemId, groupIdList) are rejected. |
voltra session delete <id> | [--delete-records] --yes [--api-key <key>] [--json] | Delete a session. Requires --yes. --delete-records also removes related training records. |
voltra session list --json
voltra session detail 12 --json
voltra session create --from ./plan.json
voltra session update 12 --from ./plan.json
voltra session delete 12 --yes
voltra session delete 12 --yes --delete-recordsUpdate is a replace-style rebuild: the backend deletes the old record and creates a new one, returning a new ID. When returned ID ≠ input ID, the CLI outputs
Replaced session <oldId> → new id <newId>.
Validation on create/update:
- Weight ≤ 200 lbs device cap (exceeding = truncated by device, corrupting cloud template).
chainsValue/inverseChainsValue≥ 0.- Failures pinpoint the path to
block[i].itemList[j].itemDetails[k].modeConfig.*.
Utilities
| Command | Options | Notes |
|---|---|---|
voltra session rename <id> <title> | [--api-key <key>] [--json] | Rename a session template. |
voltra session touch <id> | [--time <unix_seconds>] [--api-key <key>] [--json] | Update active timestamp. Default: current time. --time accepts Unix seconds (milliseconds rejected). |
voltra session rename 12 "Push Day A"
voltra session touch 12
voltra session touch 12 --time 1719900000