Record a health observation

Rejects physically implausible readings. Anything sourced from OCR is returned for user confirmation rather than stored — a misread meter value must never enter the record as fact.

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

code*string

Value in

"8480-6"
"8462-4"
"8867-4"
"2339-0"
"29463-7"
"41950-7"

valueNum*number

unit*string

effectiveAt*unknown

source*string

Value in

"healthkit"
"health_connect"
"ocr"
"manual"
"lab"

confidence?|

Range0 <= value <= 1

Defaultnull

groupId?|

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

Defaultnull

evidenceId?|

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

Defaultnull

Response Body

`application/json`

curl -X POST "https://example.com/observations" \  -H "Content-Type: application/json" \  -d '{    "code": "8480-6",    "valueNum": 0,    "unit": "string",    "effectiveAt": null,    "source": "healthkit"  }'

{  "status": "recorded"}

Record a health observation

Authorization

Request Body

Response Body

201application/json

202application/json

401application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`