# Hex (beta)

To connect Hex to Select Star, you will need to...

1. [Create an API key in Hex](#id-1.-create-an-api-key-in-hex)
2. [Create a new datasource in Select Star](#id-2.-create-a-new-data-source-in-select-star)

{% hint style="info" %}
The integration with Hex currently only supports project level lineage and does not support chart level lineage. This is due to a limitation in the metadata provided via Hex APIs.
{% endhint %}

## 1. Create an API Key in Hex

1. Go to Hex and sign in with your account
2. Once logged in, click on settings icon (at the bottom left of the screen)
3. Under **Account,** select **API keys**
4. Create new **Workspace token**:

   * provide a meaningful description
   * set an appropriate duration for the expiration date (recommend `no expiration`)
   * set the API Scope to `Read projects`

   ![](/files/jZZ4GG2J4N0nq35Kkmfy)
5. Once the key is generated, copy it to use to connect to Hex in Select Star.

## 2. Create a New Data Source in Select Star

* **Display Name** - The name you want to give to your new data source.
* **API Key** - The workspace token created in Hex from step 1.
* **Hex URL** - The URL copied from your hex instance, such as `https://app.hex.tech/selectstar/`, composed of two key parts:
  * **Base URL** - The primary domain of your Hex instance (e.g., `https://app.hex.tech`).
  * **Site ID** - The unique identifier for your specific workspace or site (e.g., `selectstar`)

![Create Data Source](/files/fbITXSEBh0JMDz3tjp7u)

Your metadata should start loading automatically, and once the sync is complete you'll be able to see Hex projects and their lineage in Select Star.


---

# 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.selectstar.com/integrations/hex.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.