Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Welcome to Theo Docs — the AI orchestration API.
Check Theo API connection, auth, and system health.
theo status for humans, theo verify for scripts.
theo statustheo status
theo.verify() against the configured baseUrl, and also probes the other host (apex vs www) to catch the apex-redirect 401 trap — the #1 cause of first-time 401s.
[theo] API key: theo_sk_live_a1b...
[theo] Base URL: https://www.hitheo.ai
[theo] ✓ Status: healthy
[theo] Version: 2026-03-28
[theo] Models available: 14
[theo] Round-trip: 186ms
[theo] ✓ Authentication OK
[theo] API key: theo_sk_live_a1b...
[theo] Base URL: https://hitheo.ai
[theo] ❌ Verification failed against https://hitheo.ai
[theo] Reason: Theo API error 401: Invalid API key
[theo] Hint: Authentication failed. Confirm your API key starts with `theo_sk_` …
[theo] Retrying against the canonical host https://www.hitheo.ai...
[theo] ✓ https://www.hitheo.ai responded with auth in 172ms.
[theo] ⚠ Your configured baseUrl appears to be a redirect target that drops the
[theo] Authorization header. Update your SDK config:
[theo] new Theo({ apiKey, baseUrl: "https://www.hitheo.ai" })
[theo] or unset THEO_BASE_URL to use the SDK default.
theo verifytheo verify
1 when authenticated is false, so you can gate CI on it.
{
"healthy": true,
"authenticated": true,
"baseUrl": "https://www.hitheo.ai",
"latencyMs": 186,
"modelCount": 14,
"version": "2026-03-28"
}
if ! theo verify > /tmp/theo.json; then
echo "Theo API unreachable or key invalid:"
jq -r '.error, .hint' /tmp/theo.json
exit 1
fi
theo.verify() in the SDK.Was this page helpful?