Support
Most problems are a base URL or a key. The doctor finds them in one click; if it does not, a ticket reaches an engineer with your diagnostics attached.
1 · Connection and receipt doctor
2 · Quick troubleshooting
How do I point my SDK at TokenZero?
Set OPENAI_BASE_URL=https://tokenzero.sh/v1 or ANTHROPIC_BASE_URL=https://tokenzero.sh (Gemini native: base URL https://tokenzero.sh) and keep your own provider key. With a workspace key, https://tokenzero.sh/w/<tz_live_key>/v1 carries the workspace in the URL so no header is needed.
I rotated my key. Did I lose history?
No. Rotation only replaces the credential; the workspace, its receipts, chain and settings are untouched. Update TOKENZERO_KEY and any /w/<key>/ base URLs; the CLI command rotate-key rewrites .env for you.
How do I turn on zero data retention?
Send x-tokenzero-zdr: true per request, or set zdr in the dashboard. In ZDR mode nothing is cached, no shadow evaluation runs, and the ledger keeps counts and costs only, never prompt or completion text.
What does billing cost and what is the guarantee?
Free up to $500 of routed spend per month. Paid plans are 15% of verified savings with the 3x-ROI-or-$0 rule: a cycle whose verified savings are not at least three times the fee costs $0. Capped plans add a monthly ceiling. Every fee is backed by signed receipts you can verify offline.
A request failed with 429 or 5xx. What now?
Enable failover (x-tokenzero-fallback: auto, or the dashboard setting): the gateway retries with jitter and can re-issue to a fallback model and key you name. The X-TokenZero-Fallback header reports what happened and the receipt records it.
How do I verify a receipt?
GET /v1/ledger/receipt/<request_id> returns the receipt and signature; verify offline with the Ed25519 public key at /.well-known/tokenzero.json, or run tokenzero verify <request_id>. tokenzero verify --chain walks the whole workspace chain.
3 · Open an engineering support ticket
Tickets are also accepted by API: POST https://tokenzero.sh/v1/support {"subject","message","email","workspace_id","category","receipt_id"}. Email support@tokenzero.sh works too.