Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mirobody.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Data Flow Overview

Health data flows through multiple stages of processing to ensure consistency, quality, and standardization across all providers.

​
The Complete Journey

1

Data Collection

Provider pulls raw data from vendor API using OAuth-authenticated requests.
raw_data = await provider.pull_from_vendor_api(
    access_token, refresh_token, days=2
)
2

Raw Storage

Original data is stored in database for audit trails and reprocessing.
await provider.save_raw_data_to_db(raw_data)
3

Transformation

Vendor-specific data is transformed into standardized format.
formatted_data = await provider.format_data(raw_data)
4

Platform Upload

Standardized data is uploaded to the Mirobody platform.
await push_service.push_data(platform="theta", data=formatted_data)
5

Availability

Data is now available for querying, analysis, and AI processing.

​
Data Transformation

The transformation stage converts vendor-specific formats into a standardized StandardPulseData format: 
StandardPulseData(
    metaInfo=StandardPulseMetaInfo(
        userId="user_123",
        requestId="req_abc",
        source="theta",
        timezone="America/Los_Angeles"
    ),
    healthData=[
        StandardPulseRecord(
            source="garmin",
            type="HEART_RATE",
            timestamp=1705276800000,
            unit="count/min",
            value=72.0,
            timezone="America/Los_Angeles"
        )
    ]
)
For more details on data mapping, see the Data Mapping Guide.