---
title: "A prescribed session as a FIT workout file"
method: POST
path: "/planned-workouts/fit"
tags: ["Training"]
---

# A prescribed session as a FIT workout file

`POST /planned-workouts/fit`

## Request

- Base URL: `https://bodylab.lol/api/v1`
- URL: `https://bodylab.lol/api/v1/planned-workouts/fit`
- Auth: HTTP bearer

Loads on Garmin, Wahoo, Hammerhead and Coros devices. Also records the plan.

## Headers

- `X-Client-Platform` string
- `X-Client-Version` string

## Request body

- object
  - `name` string, required
  - `modality` string, required: Sport, from the engine's vocabulary (packages/engine/src/sports.ts), e.g. road_biking, running, hiking, strength_training. Known values: road_biking, running, hiking, strength_training, other. Treat unknown values as "other".
  - `blocks` object[], required
    - `label` string, required
    - `repeat` integer, required
    - `work` object, required
      - `minutes` number, required
      - `zone` integer, required: Heart-rate zone, 1–5.
      - `hrLow` number, nullable
      - `hrHigh` number, nullable
      - `powerLow` number, nullable
      - `powerHigh` number, nullable
      - `speedLowMs` number, nullable
      - `speedHighMs` number, nullable
    - `recovery` object, nullable
      - `minutes` number, required
      - `zone` integer, required: Heart-rate zone, 1–5.
      - `hrLow` number, nullable
      - `hrHigh` number, nullable
      - `powerLow` number, nullable
      - `powerHigh` number, nullable
      - `speedLowMs` number, nullable
      - `speedHighMs` number, nullable
  - `forDate` string, date, required: A day on the athlete's own calendar: YYYY-MM-DD, no time zone.

## Response `200`

OK

- object
  - `filename` string, required
  - `base64` string, required: The FIT file, base64-encoded.

## Other responses

- `401`: Error: UNAUTHORIZED.
- `422`: Error: NO_WORKOUT_FILE.

---

[API](https://skmtc.dev/bodylab/apis/body-lab-api.md) · [All operations](https://skmtc.dev/bodylab/apis/body-lab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bodylab/apis/body-lab-api/revisions/544c201eaf88?raw)