Skip to main content

Authentication

Public Access (No Auth)

The Clockchain public API requires no authentication:
curl https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/stats
curl https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/moments?limit=10

Service Key Auth

Flash, Clockchain write endpoints, and Pro use X-Service-Key header authentication:
curl -H "X-Service-Key: YOUR_KEY" \
  https://api.timepointai.com/api/v1/timepoints/generate/sync

Service Keys

KeyUsed By
FLASH_SERVICE_KEYFlash API + Clockchain renderer
SERVICE_API_KEYClockchain authenticated endpoints
PRO_API_KEYPro Cloud API
ADMIN_KEYClockchain admin operations

Getting Access

Service keys are currently available via the developer preview program. Sign up at timepointai.com.

Health Check

All services expose unauthenticated health endpoints:
# Flash
curl https://api.timepointai.com/health
# → {"status":"healthy","version":"2.4.0","database":true,"providers":{"google":true,"openrouter":true}}

# Pro Cloud
curl https://timepoint-pro-cloud-private-production.up.railway.app/health
# → {"status":"healthy","service":"timepoint-pro-cloud","version":"0.1.0"}

# Clockchain (via stats)
curl https://timepoint-clockchain-deploy-private-production.up.railway.app/api/v1/stats