doctor & api
Run setup diagnostics and make raw HTTP calls to any Reflexio endpoint.
reflexio doctor / reflexio api
Two low-level tools for debugging and development:
doctor check— automated setup diagnostics (env file, API key, server reachability, Python version).api call— make a raw HTTP request to any Reflexio endpoint, with automatic Bearer-token auth.
reflexio doctor check
doctor is oriented at self-hosted setups — its failure hints point at reflexio services start and local .env files. Managed Reflexio users should use reflexio status check (server reachability) and reflexio status whoami (org identity) instead.
Run diagnostic checks on your Reflexio configuration and connectivity. Useful as a first step when something isn't working.
reflexio doctor checkChecks performed
| Check | What it verifies |
|---|---|
env_file | A .env file exists at ~/.reflexio/.env. Warning only — the CLI can still work with env variables set in the shell. |
api_key | REFLEXIO_API_KEY is resolved from env, .env, or --api-key. Warning if missing. |
server_health | GET {REFLEXIO_URL}/health returns 200. Failure if the server is unreachable or unhealthy. |
python_version | Python ≥ 3.12 (recommended). Warning if older. |
Exits with code 1 if any check reports fail. Warnings (missing env file, older Python) are non-fatal.
reflexio doctor check
reflexio --json doctor check # structured output for CIreflexio api call
Raw HTTP client for Reflexio endpoints. Handles Bearer-token auth and JSON serialization so you can test new endpoints without writing a full script.
reflexio api call <METHOD> <PATH> [--data '<json>']Prop
Type
Examples
# Health check
reflexio api call GET /health
# List agent playbooks with a filter
reflexio api call POST /api/get_agent_playbooks --data '{"limit": 5}'
# Load a larger payload from disk
reflexio api call POST /api/publish_interaction --data @payload.json
# Structured output for piping to jq
reflexio --json api call POST /api/search_profiles \
--data '{"user_id":"user_123","query":"travel"}' \
| jq '.data[0]'api call sends the same Authorization: Bearer header as every other CLI command, derived from REFLEXIO_API_KEY or --api-key. You do not need to add auth headers manually.