POST
/
v1
/
org
/
{org_id}
/
team_data_pull_preferences
/
{env}
/
{region}

Org Management API is available for the Scale plan.

The base URL of this endpoint is https://api.tryvital.io/management/.

The endpoint accepts only Org Key (X-Vital-Org-Key). Team API Key is not applicable.

By setting a higher value, you acknowledge your awareness of the facts of API life that:

  1. historical pulls may take longer to complete;
  2. historical pulls may run into provider rate limiting; and
  3. regular data polling may consequentially be delayed as a knock-on effect.

Provider rate limiting typically happens at OAuth application level.

Therefore, Vital recommends Bring Your Own OAuth if you want to set an extended historical pull range. This creates a rate limit quota dedicated to your Vital Team, not being shared with other Vital customers.

The Team Data Pull Preferences you specified is advisory. There are scenarios in which Vital systems may not adhere strictly to your stated preferences.

​
Supported Providers

ProviderDefaultConfigurableRemarks
Abbott LibreView90 days❌-
Fitbit90 days⚠️Activity and heartrate timeseries data are fixed to 14 days.
Garmin90 days✅-
Google Fit90 days✅-
Oura180 days✅-
Peloton180 days✅-
Renpho180 days✅-
Strava14 days✅-
Wahoo180 days✅-
Whoop180 days✅-
Zwift270 days✅-
Withings90 days✅-
8Sleep90 days✅-
Apple HealthKit (SDK)30 days✅-
Android Health Connect (SDK)30 days❌Google restricts access to historical data to 30 days before the first successful permission request.
Hammerhead30 days✅-
Dexcom30 days✅-
Dexcom (G6 And Older)1 day❌-
MyFitnessPal14 days✅-
Polar28 days❌Polar only supports historical backfill for Sleep and Sleep Stream resources.
Cronometer28 days✅-

The configurable maximum is 365 days at this time.

Authorizations

​
X-Vital-Org-Key
string
headerrequired

Path Parameters

​
org_id
string
required
​
env
enum<string>
required

An enumeration.

Available options:
production,
sandbox
​
region
enum<string>
required
Available options:
us,
eu

Body

application/json
​
team_ids
string[]
required
​
providers
object
required

Response

200 - application/json
​
data_pull_preferences
object[]
required
​
next_cursor
string
Get Team Data Pull PreferencesDelete Team Data Pull Preferences