Cortex References
Workout Data
Workout Data
This command group is affected by
--local-time, which converts UTC timestamps in JSON output to the local timezone.--start/--endinput params remain UTC.
Authentication
| Command | Options | Notes |
|---|---|---|
voltra workout auth-check | [--api-key <key>] [--json] | Verify API key validity. |
voltra workout auth-check
voltra workout auth-check --api-key <API_KEY>Querying Workouts
| Command | Options | Notes |
|---|---|---|
voltra workout list | [--page <n>] [--page-size <n>] [--workout-type <id>] [--start <ISO>] [--end <ISO>] [--api-key <key>] [--json] | Paginated workout history. Max page-size: 50. Max date span: 365 days. ISO format: yyyy-MM-ddTHH:mm:ss UTC. |
voltra workout sets <workout-id> | [--api-key <key>] [--json] | Sets for a workout. Useful for set order, base weight, rest periods, set-level metrics. |
voltra workout reps <workout-id> <set-id> | [--api-key <key>] [--json] | Reps for a set. Useful for rep-level detail: velocity decay, peak power, work per rep. |
voltra --json workout list --page 1 --page-size 5
voltra --json workout list --start 2026-06-01 --end 2026-06-23
voltra --json workout list --workout-type 1
voltra --json workout sets 211167
voltra --json workout reps 211167 <SET_ID>Common output fields: id, workoutTypeName, startTime / endTime, setCount / repCount, actionIds / actionNames.
Aggregation
| Command | Options | Notes |
|---|---|---|
voltra workout aggregate-sets | --start <ISO> --end <ISO> [--workout-type <id>]... [--action-id <id>]... [--connection-mode single|double] [--api-key <key>] [--json] | Aggregated set stats. --workout-type and --action-id repeatable. |
voltra workout aggregate-reps | --start <ISO> --end <ISO> [--workout-type <id>]... [--action-id <id>]... [--group-by day|week|month] [--api-key <key>] [--json] | Aggregated rep stats. Filters repeatable. |
voltra --json workout aggregate-sets --start 2026-06-01 --end 2026-06-23
voltra --json workout aggregate-sets --start 2026-06-01 --end 2026-06-23 --workout-type 1 --action-id 33
voltra --json workout aggregate-reps --start 2026-06-01 --end 2026-06-23 --group-by dayScript Examples
# Last 5 workout summaries (local timezone)
voltra --local-time --json workout list --page 1 --page-size 5 \
| jq -r '.list[] | "\(.id)\t\(.workoutTypeName)\t\(.startTime)\tsets=\(.setCount)\treps=\(.repCount)"'
# Drill down into a specific workout
WORKOUT_ID=$(voltra --json workout list --page 1 --page-size 1 | jq -r '.list[0].id')
voltra --json workout sets "$WORKOUT_ID"
SET_ID=$(voltra --json workout sets "$WORKOUT_ID" | jq -r '.list[0].id')
voltra --json workout reps "$WORKOUT_ID" "$SET_ID"