Skip to content
Browse documentation
Add data / ATH documentation

ath link

Attach a logged result to a device-recorded session.

Usage

$ath link <result-id> <session-id> --revision 1 --json

Arguments

<result-id>
Required stable benchmark-result record ID.
<session-id>
Required stable workout-session record ID.

What it does

Previews a stable-ID link, then writes it as a new revision of the benchmark result after confirmation. A stale expected revision is refused.

Examples

Find the record IDs and current result revision first. Preview with --json or --dry-run, then repeat with --yes after review.

$ath records list --type benchmark_result
$ath records list --type workout_session
$ath link <result-id> <session-id> --revision 1 --yes

Options

--revision <number>
current result revision from the preview
--file <path>
change a database other than the one in this folder
-y, --yes
write after reviewing the preview
--dry-run
show what would change and write nothing
--json
structured preview; never confirms the write

Related commands

Up nextath correct →