hex-install-auth

# Hex Install & Auth ## Overview Configure Hex API authentication using OAuth 2.0 Bearer tokens. The Hex API at `app.hex.tech/api/v1/` lets you programmatically trigger project runs, check status, manage users, and configure connections. Tokens are generated per-user in the Hex workspace settings. ## Prerequisites - Hex account (Team or Enterprise plan) - Workspace admin access for API token generation - At least one published Hex project ## Instructions ### Step 1: Generate API Token 1. Open Hex workspace settings 2. Navigate to **API tokens** section 3. Click **New Token** 4. Set description and expiration 5. Select scopes: "Read projects" and/or "Run projects" ### Step 2: Configure Environment ```bash # .env (NEVER commit) HEX_API_TOKEN=hex_token_abc123... HEX_WORKSPACE_URL=https://app.hex.tech # .gitignore .env .env.local ``` ### Step 3: Verify Connection ```typescript // verify-hex.ts import 'dotenv/config'; const TOKEN = process.env.HEX_API_TOKEN!; async function verify() { const response = await fetch('https://app.hex.tech/api/v1/projects', { headers: { 'Authorization': `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }, }); if (!response.ok) throw new Error(`Hex API ${response.status}`); const projects = await response.json(); console.log(`Connected! Found ${projects.length} projects`); return projects; } verify().catch(console.error); ``` ```bash # curl verification curl -s -H "Authorization: Bearer $HEX_API_TOKEN" \ https://app...