Skip to content
Helix
PricingDocsChangelog
Log inStart free
Documentation
Overview
Getting Started with HelixYour First Mission WalkthroughFocus Mode vs Console ModeDesktop & Mobile Companion Apps
5-Minute API QuickstartIntegrations & Autonomous ChannelsProduction Examples & Recipes
Helix Agent Overview & Autonomy TiersHelix AdvisorHelix OperatorHelix PhasesHelix Sandbox
Synthetic AI & Simulation WorkflowsDrop-In White-Label Agent EmbedsDeveloper & Embed Guide
Helix ArchitectureArchitecture & Technical GuideHybrid Compute Bridge & Custom MCPHelix MCP
MCP Providers & Cloud Connectors
REST, Gateway & MCP API ReferenceAuthentication, Keys & ScopesSDKs & Programmatic ClientsWebhooks, HMAC Verification & ReplayTroubleshooting & Error Playbook
Helix Security ArchitectureEnterprise Security, Secrets & GovernanceBilling, Compute Windows & Quotas
Developer PlatformDeveloper Console
Docs/API, SDKs & Webhooks/Authentication, Keys & Scopes

Authentication, Keys & Scopes

Every request entering LaunchVerse & Helix enforces explicit least-privilege credential boundaries, constant-time token verification, and workspace-scoped isolation.

Key Prefixes & Security Boundaries

PrefixIntended RuntimeAllowed Scopes & Restrictions
Session CookieHelix Web (launchverse.app)Interactive workspace member authentication managed by session auth.
hx_live_*Backend servers, CI/CD runners, REST, MCPFull workspace programmatic access capped only by key permissions & RPM/RPD limits.
hx_test_*CI smoke checks & staging sandboxesRuns dry-run simulations where external writes are blocked; logs audit entries with isTest: true.
hx_embed_*Customer browser Web ComponentsPinned to exactly one external principalId; blocks cross-tenant queries and rejects /api/webhooks/platform + key minting (403 principal_escalation_denied).
hx_bridge_*Outbound Private VPC Bridge daemonPermits tunneling strictly to hosts explicitly listed in the bridge allow-list.
lvse_*Team Owner automation CLIOwner-level deployment & billing automation token.

Required HTTP Headers

Send your key via standard bearer Authorization alongside the pinned API version header:

HTTP
Authorization: Bearer hx_live_your_secret_key
Helix-Version: 2026-11-16
Content-Type: application/json

Optional workspace disambiguation header (when one key spans multiple workspaces):

HTTP
X-Helix-Workspace: ws_01J...

Rate Limits & Monthly Token Budgets

Keys minted under Developer Console -> API Keys carry optional hardware/cost guardrails:

  • rate_limit_rpm — requests per minute burst cap
  • rate_limit_rpd — requests per rolling 24h cap
  • token_budget_monthly — hard monthly inference token ceiling

When a ceiling triggers, the gateway responds immediately with HTTP 429:

JSON
{
  "error": "rate_limit_exceeded",
  "retryAfterSeconds": 18,
  "limit": "60 rpm"
}

Key Rotation Without Downtime

  1. Open Developer Console -> API Keys -> Create Key to mint a replacement secret.
  2. Deploy the new secret to your CI / backend environment and confirm live requests succeed.
  3. Click Revoke on the legacy key ID (DELETE /api/helix/keys?id=...). Revocation takes effect immediately across every edge worker and gateway.
  4. For workspace secrets (database URLs, cloud tokens, webhooks), configure encrypted environment variables in Environments (AES-256-GCM sealed at rest; decrypted exclusively inside running sandboxes).
PreviousREST, Gateway & MCP API ReferenceNext SDKs & Programmatic Clients
Edit this page on GitHub↗

Platform

How Helix worksSpecialist crewScreens & architectureSecurity & isolationSystem status

Products

Helix WorkspaceAI Staff & Role PacksEmbedded B2B2C StaffPricing & plans

Developers

Developer PlatformDeveloper ConsoleAPI ReferenceSDKs & CLIWebhooks & events

Resources

DocumentationQuickstart guideChangelogHelp Center

Solutions

Use casesCode migrationCVE remediationMulti-cloud ops

Company

About LaunchVerseCareersContact ussupport@launchverse.app

Legal

Privacy PolicyTerms of ServiceExternal status

Social

Sovereign agentic infrastructure engineered in Africa for global engineering teams.

Helix

AI Specialists & Assistants for Everyday Work.

© 2026 LaunchVerse (Helix). All rights reserved.Privacy·Terms·Security·Status