---
title: "Hex integration for LuumenAI"
url: "https://www.luumen.ai/integrations/hex/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Hex integration for LuumenAI

Read Hex projects, runs, and sharing — change access as an approved step

## What LuumenAI can do with Hex

LuumenAI connects to Hex with an API token and exposes 32 tools (13 read-only · 15 write · 4 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 32 tools (13 read-only · 15 write · 4 destructive)
- Plan: available on all plans
- Category: Databases & data platforms

## About Hex with LuumenAI

Connect Hex and Luumen can read your workspace the way an analyst would: which projects exist, who is in which group, what a scheduled run did last night, and which cells make up a draft. When something needs to change — sharing a project with a group, creating a collection, canceling a stuck run — Luumen shows the change first and waits for your approval. Auth is by API key.

## Example tools

Read-only (13 in total):

- `HEX_GET_CELL` — Get a single cell by ID from the draft version of a Hex project.
- `HEX_GET_COLLECTION` — Get information about a specific collection in Hex.
- `HEX_GET_GROUP` — Retrieve information about a specific Hex group.
- `HEX_GET_PROJECT` — Get metadata about a single Hex project.
- `HEX_GET_PROJECT_RUNS` — Retrieve the status of API-triggered runs for a specific Hex project.
- `HEX_GET_RUN_CHART_IMAGE` — Retrieve a rendered chart image from a Hex project run.
- `HEX_GET_RUN_STATUS` — Retrieve the status of a specific Hex project run.
- `HEX_LIST_CELLS` — List all cells from the draft version of a Hex project.

Write and destructive (19 in total, approval required by default):

- `HEX_CANCEL_RUN` — Cancel a project run that is in progress.
- `HEX_CREATE_CELL` — Create a new cell in the draft version of a Hex project.
- `HEX_CREATE_COLLECTION` — Create a new collection in the Hex workspace.
- `HEX_CREATE_GROUP` — Create a new group in the Hex workspace.
- `HEX_DEACTIVATE_USER` — Deactivates a user in the Hex workspace.
- `HEX_DELETE_CELL` — Permanently delete a cell from the draft version of a project.
- `HEX_DELETE_GROUP` — Deletes a group from the Hex workspace.
- `HEX_DELETE_GUIDE_DRAFT` — Deletes a guide draft by ID from Hex.

## Frequently asked questions

### How does LuumenAI connect to Hex?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Hex on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 4 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Hex — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/hex/