Upload absolute cumulative steps since the server-issued countingFrom

Poll about every 15 seconds. measuredAt is the observation cutoff (observed-until), not upload time. Count only from the server-issued countingFrom through measuredAt, never past endsAt. A final upload may arrive up to five minutes after endsAt; the reading must still be at most five minutes old. Reuse the exact measuredAt, source and steps on retry. Scores remain provisional and cannot award rewards. Uploads must be monotonic and below 300 steps/minute both cumulatively and since the last observation cutoff. No manual, OCR or mock source is accepted.

Authorization

bearer

AuthorizationBearer <token>

In: header

Path Parameters

id*string

Match

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

steps*integer

Range0 <= value <= 1000000

measuredAt*string

Match

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

Formatdate-time

countingFrom*string

Match

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

Formatdate-time

source*string

Value in

"healthkit"
"pedometer"
"health_connect"

Response Body

`application/json`

curl -X POST "https://example.com/v1/community/challenges/497f6eca-6276-4993-bfeb-53cbbbba6f08/progress" \  -H "Content-Type: application/json" \  -d '{    "steps": 0,    "measuredAt": "2019-08-24T14:15:22Z",    "countingFrom": "2019-08-24T14:15:22Z",    "source": "healthkit"  }'

{  "status": "accepted",  "enrollment": {    "participantId": "9f6624b5-5f99-42b6-899f-30f2b369cbd7",    "alias": "string",    "joinedAt": "2019-08-24T14:15:22Z",    "countingFrom": "2019-08-24T14:15:22Z",    "shareLeaderboard": true,    "sharePublicDisplay": true,    "steps": 0,    "measuredAt": "2019-08-24T14:15:22Z",    "provisional": true,    "rewardEligible": false  }}

Upload absolute cumulative steps since the server-issued countingFrom

Authorization

Path Parameters

Request Body

Response Body

200application/json

428application/json

`application/json`

`application/json`