---
title: "Choose the source of the step series"
method: PUT
path: "/wellness/steps/source"
tags: ["Recovery"]
---

# Choose the source of the step series

`PUT /wellness/steps/source`

## Request

- Base URL: `https://bodylab.lol/api/v1`
- URL: `https://bodylab.lol/api/v1/wellness/steps/source`
- Auth: HTTP bearer

Every day's count comes from one source. By default that is the source with the most counts, and it moves when another overtakes it; choosing one fixes it until it's chosen again or set back to null. Every past day is re-resolved onto the source, so a day only that source counted gains a count and a day it didn't count loses one. Answers with the series' sources as GET /wellness/steps reports them.

## Headers

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

## Request body

- object
  - `source` string, nullable, required: A source from GET /wellness/steps `sources`, or null to go back to the one with the most counts.

## Response `200`

OK

- object
  - `seriesSource` string, nullable, required: The source every day's count comes from now: chosenSource when set, otherwise the source with the most counts (the earliest to report on a tie). Null before any count.
  - `chosenSource` string, nullable, required: The source the athlete chose for steps (PUT /wellness/steps/source), or null while Body Lab picks the one with the most counts.
  - `sources` object[], required: Every source with a count on record, most days first: what the athlete can choose between. Choosing matters only when there are two or more.
    - `source` string, required: A connected service or device that has counted steps (e.g. garmin, apple_health).
    - `days` integer, required: Days it has a count for, across everything on record, not only the days returned.

## Other responses

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

---

[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)