Gateway

Hyphen Gateway is the public front door for SaaS and hybrid deployments.

Base URL: https://apisvr.tryhyphen.com

What it does

  • Authenticates API keys and management tokens
  • Maps key to tenant and injects X-Org-Id upstream
  • Applies request-level rate limiting
  • Exposes self-serve signup and tenant management APIs
  • Exposes license APIs for on-prem validation

Key routes

Public

  • GET /health
  • POST /gateway/signup

Tenant management (Authorization: Bearer mt-hyp-...)

  • GET /gateway/account
  • POST /gateway/account/regenerate-token
  • GET /gateway/orgs
  • POST /gateway/orgs
  • PUT /gateway/orgs/:orgId
  • GET /gateway/orgs/:orgId/keys
  • POST /gateway/orgs/:orgId/keys
  • DELETE /gateway/orgs/:orgId/keys/:keyId
  • POST /gateway/orgs/:orgId/keys/:keyId/rotate
  • GET /gateway/orgs/:orgId/usage
  • GET /gateway/licenses

Platform Administration

Admin routes are available for platform operators managing tiers, accounts, licensing, and usage monitoring.

Licensing

  • POST /licensing/validate
  • GET /licensing/public-key

Runtime proxy calls

For product/runtime API calls, send:

  • Authorization: Bearer sk-hyp-...

Gateway forwards to engine with tenant headers injected.