Hex

Data workspace API for running projects, managing notebooks, and embedding analytics. Best for triggering data pipeline runs, polling execution status, and generating embeddable analytics URLs. Unlike Jupyter (local notebooks), Hex is a collaborative cloud platform with scheduling, SQL cells, and a project-level API. 8 example endpoints available through Lava’s AI Gateway. See the Hex API docs for full documentation.

This provider requires your own credentials — connect your API key or OAuth account before use.

This is a catch-all provider — any valid URL under https://app.hex.tech is supported. Any Hex API endpoint. Construct URL as https://app.hex.tech/api/v1/{path}. See https://learn.hex.tech/docs/api-integrations/api/reference for full reference. The endpoints below are curated examples.

Endpoints

Trigger a project run with optional input parameters

POST https://app.hex.tech/api/v1/projects/{project_id}/runs — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects/{project_id}/runs', { body: {"inputParams":{}} });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects%2F%7Bproject_id%7D%2Fruns" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inputParams":{}}'

Get the status of a project run

GET https://app.hex.tech/api/v1/projects/{project_id}/runs/{run_id} — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects/{project_id}/runs/{run_id}', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects%2F%7Bproject_id%7D%2Fruns%2F%7Brun_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List projects in the workspace

GET https://app.hex.tech/api/v1/projects — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Get project details

GET https://app.hex.tech/api/v1/projects/{project_id} — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects/{project_id}', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects%2F%7Bproject_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Cancel a running project execution

POST https://app.hex.tech/api/v1/projects/{project_id}/runs/{run_id}/cancel — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects/{project_id}/runs/{run_id}/cancel', { method: 'POST' });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects%2F%7Bproject_id%7D%2Fruns%2F%7Brun_id%7D%2Fcancel" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Replace project configuration

PUT https://app.hex.tech/api/v1/projects/{project_id} — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects/{project_id}', { method: 'PUT', body: {"name":"Project Name","description":"Full replacement"} });

curl -X PUT "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects%2F%7Bproject_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Project Name","description":"Full replacement"}'

Update project metadata

PATCH https://app.hex.tech/api/v1/projects/{project_id} — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects/{project_id}', { method: 'PATCH', body: {"name":"Updated Project Name"} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects%2F%7Bproject_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Updated Project Name"}'

Delete a project

DELETE https://app.hex.tech/api/v1/projects/{project_id} — Free

SDK
cURL

const data = await lava.gateway('https://app.hex.tech/api/v1/projects/{project_id}', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapp.hex.tech%2Fapi%2Fv1%2Fprojects%2F%7Bproject_id%7D" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Get Started

AI Gateway

AI Spend

Monetize

Integration

SDK

Cookbook

Comparisons

Endpoints

Trigger a project run with optional input parameters

Get the status of a project run

List projects in the workspace

Get project details

Cancel a running project execution

Replace project configuration

Update project metadata

Delete a project

Next Steps

All Providers

Forward Proxy

​Endpoints

​Trigger a project run with optional input parameters

​Get the status of a project run

​List projects in the workspace

​Get project details

​Cancel a running project execution

​Replace project configuration

​Update project metadata

​Delete a project

​Next Steps

All Providers

Forward Proxy

Endpoints

Trigger a project run with optional input parameters

Get the status of a project run

List projects in the workspace

Get project details

Cancel a running project execution

Replace project configuration

Update project metadata

Delete a project

Next Steps