Skip to content
Docs menu

Back to all methods

setActivityDistance

write

Sets an activity's total distance in meters; Garmin recomputes the average speeds. Partial PUT of `summaryDTO.distance` in METERS (no conversion; `createManualActivity` is the one that takes km), the edit Garmin Connect offers for treadmill runs. Garmin recomputes `averageSpeed`/`averageMovingSpeed` from it; duration, calories and laps stay as recorded, so the laps no longer sum to the total. `getActivities` lags the change by a few seconds while `getActivity` shows it at once. Throws `GarminError` before any request for a non-positive or non-finite value.

setActivityDistance(activityId, meters)
ParameterTypeOptionalDescription
activityIdnumber | stringnoNumeric id
metersnumberno

In Claude this is the set_activity_distance tool.

Guide: activities