Decisions not appearing in Monitoring
Check API key
Check API key
Verify
HISTEERIA_API_KEY is set and matches a non-revoked key in Settings.Call flush()
Call flush()
In scripts and serverless, call
flush() before process exit. Fire-and-forget queues may not drain otherwise.Enable debug mode
Enable debug mode
Verify base URL
Verify base URL
Default is
https://api.histeeria.com. Override with HISTEERIA_BASE_URL only for non-standard deployments.Decisions stuck in queued
Evaluation runs asynchronously. If decisions stay queued for extended periods:- Agent may still be in warmup — send more representative decisions
- Check Evaluation engine status in the app
- Contact support if queue doesn’t clear after warmup
Scores seem wrong
- Update agent profile description to match production policies
- Check
domain— wrong domain skews evaluation context - Review the specific decision input/output in Monitoring
- Compare dimension trends, not single scores in isolation
401 Unauthorized
- Key revoked or typo in env var
- Wrong header format:
Authorization: Bearer hst_live_... - Using JWT where API key is required (ingest needs API key)
High volume / rate limits
- SDK batches internally; avoid tight loops of synchronous HTTP ingest
- Contact support for enterprise limits if you hit 429 responses

