Authentication

All API requests require authentication via Bearer token.

API Key Format

uc_live_xxxxxxxxxxxxxxxxxxxxxxxxxx
uc_test_xxxxxxxxxxxxxxxxxxxxxxxxxx

import { UltraContext } from 'ultracontext'

const uc = new UltraContext({
  apiKey: process.env.ULTRACONTEXT_API_KEY
})

Include the API key in the Authorization header:

curl https://api.ultracontext.ai/contexts \
  -H "Authorization: Bearer uc_live_xxxxx"

Never hardcode API keys. Use .env files or secret managers.

Add .env to .gitignore. Use .env.example for templates.

If a key is compromised, regenerate it immediately in the dashboard.

Use uc_test_ keys during development to avoid polluting production data.

# .env
ULTRACONTEXT_API_KEY=uc_live_xxxxx

# .env.example (commit this)
ULTRACONTEXT_API_KEY=uc_live_your_key_here

// Load from environment
const uc = new UltraContext({
  apiKey: process.env.ULTRACONTEXT_API_KEY!
})

API keys should only be used server-side. Never expose them in client-side code or browser JavaScript.

For client-side applications, create a backend API route that proxies requests to UltraContext.