用途：把结构化训练一次性定义为模板，再由 Terra API 同步到用户已连接的设备，如 Garmin、COROS、Wahoo、Suunto、TrainingPeaks、Huawei、Zepp、Hevy 或 Apple。这是写入设备方向的产品，与偏读取的 Terra 健康与健身数据流相反。该产品处于预发布阶段，端点、字段与厂商行为可能变化，上线前需对照官方文档核验。
主要能力：两阶段流程。第一阶段 POST /workouts 创建可复用模板，返回 workout_id，模板含结构与基于百分比的个性化目标。第二阶段 POST /workouts/{workout_id}/plan?user_id=X 在排期时套用该运动员参数（如最大心率、FTP），把百分比目标换算为绝对值并推送到设备，返回 planned_workout_id 与 provider_workout_id。数据模型为 WorkoutTemplate → step_blocks[] → steps[] → intensity_targets[]；目标有绝对值、百分比、区间三类。
使用方式：每个请求需带 dev-id 与 x-api-key 头，基础地址为 https://access.tryterra.co/api/v2。可用 CLI 手动跑通流程，如 terra data-api /workouts、terra data-api /workouts/<id>/plan、terra data-api /plannedWorkouts 等；在 Claude Code、Codex、Cursor 等编码智能体中用 CLI，缺失可安装：curl -fsSL https://cli.tryterra.co/install.sh | sh（macOS/Linux），irm "https://cli.tryterra.co/install.ps1" | iex（Windows PowerShell），或用 Homebrew、npm。在 claude.ai、Claude Desktop、ChatGPT 等聊天助手中用 Terra API admin MCP 服务器。
限制与注意：DELETE /workouts/{id} 会级联删除并不可逆；PATCH 只能改 planned_date；厂商支持差异大，不支持的操作仍可能返回成功；COROS 更新等于删除重建；Huawei 仅创建、仅跑步、不排期；Zepp 有 7 天同步窗口；Hevy 仅力量且丢弃 RPE；Apple 经 iOS SDK 同步。厂商无法精确表达时会触发 coercion，仍创建成功并返回 coercion_warnings[]。百分比目标在模板创建时拒绝单值，需提供 value_low 或 value_high。所有 Terra ID 以 JSON 字符串序列化。官方要求对照 docs.tryterra.co/planned-workouts-api，并参考 provider-compatibility、coercion-scenarios、exercise-reference 等文档；Garmin 动作目录与各运动示例需另行获取。资料未提供计费、价格、上线时间与除上述厂商外的平台信息。