# Exist

Your Toolhouse AI Worker can connect to Exist using 12 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=exist).

## Tools (12)

### `Exist Acquire Attribute Ownership`

Integration name: **EXIST\_ACQUIRE\_ATTRIBUTE\_OWNERSHIP**

Tool to acquire ownership of attributes for the authenticated user. Allows your service to write data to these attributes. Use when you need to create or take ownership of attributes before writing data. Acquiring a templated attribute the user doesn't have yet will create this attribute and give you ownership.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type  | Required | Example                                          | Description                                             |
| ------------ | ----- | :------: | ------------------------------------------------ | ------------------------------------------------------- |
| `attributes` | array |     ✅    | `[{"template":"mood"},{"template":"mood_note"}]` | List of attributes to acquire ownership of (maximum 35) |

***

### `Exist Get Attributes With Values`

Integration name: **EXIST\_GET\_ATTRIBUTES\_WITH\_VALUES**

Tool to retrieve attributes with their current values for the authenticated user. Use when you need both attribute metadata and their historical values. Results are limited to your read scopes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example               | Description                                                                                                   |
| ------------ | ------- | :------: | --------------------- | ------------------------------------------------------------------------------------------------------------- |
| `page`       | integer |          | `1`                   | Page number for pagination (1-based indexing)                                                                 |
| `limit`      | integer |          | `20`                  | Page size for pagination (number of attributes per page)                                                      |
| `groups`     | string  |          | `"activity,workouts"` | Filter to only attributes in these groups, as comma-separated list of group names (e.g., 'activity,workouts') |
| `date_max`   | string  |          | `"2024-12-31"`        | Maximum date for values in ISO format YYYY-MM-DD (e.g., '2024-12-31')                                         |
| `date_min`   | string  |          | `"2024-01-01"`        | Minimum date for values in ISO format YYYY-MM-DD (e.g., '2024-01-01')                                         |
| `attributes` | string  |          | `"steps,sleep"`       | Filter to only these attributes, as comma-separated list of attribute names (e.g., 'steps,sleep')             |

***

### `Exist Get Attribute Templates`

Integration name: **EXIST\_GET\_ATTRIBUTE\_TEMPLATES**

Tool to retrieve a paged list of supported attribute templates. Use when you need to browse available templates before creating or updating data.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example | Description                                      |
| ---------------------- | ------- | :------: | ------- | ------------------------------------------------ |
| `page`                 | integer |          | —       | Page index, starting at 1                        |
| `limit`                | integer |          | —       | Number of results per page                       |
| `groups`               | array   |          | —       | Filter by groups, e.g., \['activity','workouts'] |
| `include_low_priority` | boolean |          | —       | Include templates with priority >= 10            |

***

### `Exist Get Averages`

Integration name: **EXIST\_GET\_AVERAGES**

Tool to retrieve the most recent average values for each tracked attribute, with one set per week. Returns overall weekly averages plus daily breakdowns (Monday-Sunday). Use include\_historical flag to retrieve historical average records.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type    | Required | Example                   | Description                                                                |
| -------------------- | ------- | :------: | ------------------------- | -------------------------------------------------------------------------- |
| `page`               | integer |          | `1`                       | Page index, 1-based. Defaults to 1.                                        |
| `limit`              | integer |          | `20`                      | Number of results per page.                                                |
| `groups`             | array   |          | `["activity","workouts"]` | Filter by attribute groups. Provide a list, e.g. \['activity','workouts']. |
| `date_max`           | string  |          | `"2024-12-31"`            | Maximum (most recent) date inclusive, in yyyy-mm-dd format.                |
| `date_min`           | string  |          | `"2024-01-01"`            | Minimum (oldest) date inclusive, in yyyy-mm-dd format.                     |
| `attributes`         | array   |          | `["steps","floors"]`      | Filter by specific attributes. Provide a list, e.g. \['steps','floors'].   |
| `include_historical` | boolean |          | `true`                    | Set true to retrieve historical average records.                           |

***

### `Exist Get Correlations`

Integration name: **EXIST\_GET\_CORRELATIONS**

Retrieve a paginated list of correlations discovered between tracked attributes in the last week. Correlations reveal statistical relationships between different metrics (e.g., sleep duration vs mood). Filter by relationship strength, confidence level (statistical significance), or specific attributes. Returns correlation coefficients, p-values, and human-readable descriptions.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example   | Description                                                                                                                                                 |
| ----------- | ------- | :------: | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `page`      | integer |          | `1`       | Page index (default 1)                                                                                                                                      |
| `limit`     | integer |          | `20`      | Number of items per page (max 100)                                                                                                                          |
| `strong`    | boolean |          | `true`    | Filter to return only correlations above a certain relationship strength threshold (stronger correlations indicate closer relationships between attributes) |
| `attribute` | string  |          | `"steps"` | Filter correlations to this attribute name                                                                                                                  |
| `confident` | boolean |          | `true`    | Filter to return only correlations with five-star confidence (highest statistical significance, certain to be related)                                      |

***

### `Exist Get Insights`

Integration name: **EXIST\_GET\_INSIGHTS**

Tool to retrieve automatically-generated insights about patterns in tracked data for the authenticated user. Insights are observations about correlations, trends, and anomalies (e.g., "You walked more on days you slept well"). Use when analyzing user behavior patterns or displaying personalized feedback.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type    | Required | Example        | Description                                                                  |
| ---------- | ------- | :------: | -------------- | ---------------------------------------------------------------------------- |
| `page`     | integer |          | `1`            | Page index, 1-based. Defaults to 1.                                          |
| `limit`    | integer |          | `20`           | Number of insights to return per page (max 100)                              |
| `date_max` | string  |          | `"2024-12-31"` | Most recent date (inclusive) of results to be returned, in format YYYY-MM-DD |
| `date_min` | string  |          | `"2024-01-01"` | Oldest date (inclusive) of results to be returned, in format YYYY-MM-DD      |
| `priority` | integer |          | `1`            | Filter by insight priority, where 1 = today and 4 = last month               |

***

### `Exist Get Owned Attributes`

Integration name: **EXIST\_GET\_OWNED\_ATTRIBUTES**

Tool to retrieve attributes owned by your service for the authenticated user. Use when you need to limit data updates to only the attributes your service controls.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                        | Description                                                                     |
| ---------------------- | ------- | :------: | ------------------------------ | ------------------------------------------------------------------------------- |
| `page`                 | integer |          | `1`                            | Page index, 1-based. Defaults to 1.                                             |
| `limit`                | integer |          | `20`                           | Number of results per page.                                                     |
| `groups`               | array   |          | `["activity","workouts"]`      | Filter by attribute groups. Provide a list, e.g. \['activity','workouts'].      |
| `manual`               | boolean |          | `true`                         | If true, only manual attributes; if false, excludes them.                       |
| `attributes`           | array   |          | `["sleep_efficiency","steps"]` | Filter by attribute names. Provide a list, e.g. \['sleep\_efficiency','steps']. |
| `exclude_custom`       | boolean |          | `true`                         | If true, only templated attributes are returned.                                |
| `include_inactive`     | boolean |          | `true`                         | If true, includes inactive attributes (active=false).                           |
| `include_low_priority` | boolean |          | `true`                         | If true, includes attributes with priority >= 10.                               |

***

### `Exist Get User Attributes`

Integration name: **EXIST\_GET\_USER\_ATTRIBUTES**

Tool to retrieve a paged list of the user's attributes without values. Use when you need metadata on available attributes for filtering or selection. Omitting `groups` and `attributes` filters returns the full attribute catalog; use those filters to narrow results and avoid oversized responses.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter              | Type    | Required | Example                        | Description                                                                     |
| ---------------------- | ------- | :------: | ------------------------------ | ------------------------------------------------------------------------------- |
| `page`                 | integer |          | `1`                            | Page index, 1-based. Defaults to 1.                                             |
| `limit`                | integer |          | `20`                           | Number of results per page.                                                     |
| `owned`                | boolean |          | `true`                         | If true, only attributes owned by this client are returned.                     |
| `groups`               | array   |          | `["activity","workouts"]`      | Filter by attribute groups. Provide a list, e.g. \['activity','workouts'].      |
| `manual`               | boolean |          | `true`                         | If true, only manual attributes; if false, excludes them.                       |
| `attributes`           | array   |          | `["sleep_efficiency","steps"]` | Filter by attribute names. Provide a list, e.g. \['sleep\_efficiency','steps']. |
| `exclude_custom`       | boolean |          | `true`                         | If true, only templated attributes are returned.                                |
| `include_inactive`     | boolean |          | `true`                         | If true, includes inactive attributes (active=false).                           |
| `include_low_priority` | boolean |          | `true`                         | If true, includes attributes with priority >= 10.                               |

***

### `Exist Get User Profile`

Integration name: **EXIST\_GET\_USER\_PROFILE**

Tool to retrieve the authenticated user's profile details and preferences. Use after authentication to inspect account settings and status. OAuth scopes granted during authentication determine which fields are returned; missing fields indicate insufficient scopes. Response includes a timezone field; use it when interpreting any date-based attributes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.*

***

### `Exist Increment Attribute Values`

Integration name: **EXIST\_INCREMENT\_ATTRIBUTE\_VALUES**

Tool to increment attribute values by a delta amount rather than setting totals. Use for counters and cumulative data. Does not work with string, scale, or time of day attributes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type  | Required | Example                                                                                                 | Description                                                                                                                    |
| ------------ | ----- | :------: | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `attributes` | array |     ✅    | `[{"date":"2026-02-14","name":"steps","value":100},{"date":"2026-02-14","name":"push_ups","value":10}]` | List of attributes to increment with name, date, and delta value. Does not work with string, scale, or time of day attributes. |

***

### `Exist Oauth2 Authorize`

Integration name: **EXIST\_OAUTH2\_AUTHORIZE**

Constructs an OAuth2 authorization URL for Exist.io. This tool generates the URL that users must visit in their browser to grant permissions to your application. After user consent, Exist redirects back to your redirect\_uri with an authorization code that can be exchanged for an access token. This action does not make an API call - it only builds the authorization URL.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                          | Description                                                                                                                                                                                                                                                                                                                                   |
| --------------- | ------ | :------: | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `scope`         | string |     ✅    | `"manual_read manual_write"`     | Space-separated list of permission scopes to request. Available scopes follow the pattern \[category]\_read or \[category]\_write. Categories include: activity, productivity, mood, sleep, workouts, events, finance, food, health, location, media, social, weather, custom, and manual. Example: 'activity\_read mood\_write custom\_read' |
| `state`         | string |          | `"random_csrf_token"`            | Optional opaque value used to maintain state between the authorization request and callback. Recommended for CSRF protection - generate a random token, store it in your session, and verify it matches when the user returns to your redirect\_uri                                                                                           |
| `client_id`     | string |     ✅    | `"your_client_id_here"`          | The client application's ID, as assigned by Exist                                                                                                                                                                                                                                                                                             |
| `redirect_uri`  | string |     ✅    | `"https://yourapp.com/callback"` | HTTPS URI where the user will be redirected after authorization. Must match the redirect URI registered with your Exist OAuth2 client application. The authorization code will be appended as a query parameter to this URI                                                                                                                   |
| `response_type` | string |          | `"code"`                         | OAuth2 response type. Must be 'code' for authorization code flow. This parameter defaults to 'code' and typically does not need to be changed                                                                                                                                                                                                 |

***

### `Exist Release Attribute Ownership`

Integration name: **EXIST\_RELEASE\_ATTRIBUTE\_OWNERSHIP**

Tool to release ownership of attributes for the authenticated user. Use when your service will stop providing data for an attribute or becomes inactive.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type  | Required | Example                                  | Description                                                                    |
| ------------ | ----- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------ |
| `attributes` | array |     ✅    | `[{"name":"mood"},{"name":"mood_note"}]` | List of attributes to release ownership of. Maximum 35 attributes per request. |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/exist.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.