用途：Terra API Routes 是写设备（write-to-device）产品，预发布阶段。定义一次带航点的 GPS 路线，由 Terra API 推送到用户已连接的设备，用户下次同步后路线出现在手表或码表上，应用无需适配各厂商原生路线格式。
主要能力与工作流程：采用两阶段流程。第一步 POST /routes 创建可复用模板返回 route_id；第二步 POST /routes/{route_id}/push?user_id=X 推送到用户设备，返回 pushed_route_id 与 provider_route_id。基址为 https://access.tryterra.co/api/v2，每个请求需 dev-id 与 x-api-key 两个请求头。
端点包括创建、列出、获取、更新（PUT 为部分更新返回 200，加 ?cascade 会异步重新推送返回 202）、删除模板，以及推送、列出、获取、删除已推送路线。
数据模型：RouteTemplate 含 name、sport、waypoints（必填），以及 description、elevation_gain_meters、elevation_loss_meters、speed_meters_per_second（可选）。sport 共 8 种：running、trail_running、hiking、cycling、road_biking、mountain_biking、gravel_cycling、other。航点需纬度经度，可选 elevation_meters 与 course_point。
使用方式：在编码代理中用 CLI，缺失时可安装：curl -fsSL https://cli.tryterra.co/install.sh | sh（macOS/Linux）、irm "https://cli.tryterra.co/install.ps1" | iex（Windows PowerShell）。在聊天助手中用 Terra API admin MCP。路线调用为 terra data-api，仅 CLI 具备。
限制：仅支持 Garmin、COROS、Wahoo，覆盖差异明显。course_point、speed_meters_per_second、description 仅 Garmin 生效，其余厂商静默忽略；COROS 不支持删除与检索，且仅两个内部运动类型；重复推送同一模板会产生重复记录；不支持的删除仍可能返回成功。Garmin 高程为整条路线全有或全无。文档为预发布，可能尚未发布。