scribasedocs

CLI Reference

scribase doctor

Verifies that the management API is reachable and that your access token is configured correctly.

Usage

Terminal
scribase doctor

What it checks

  1. Endpoint configured — SCRIBASE_API_URL is set and is a valid URL.
  2. Management API ready — GET /health/ready returns 204.
  3. Access token present — SCRIBASE_ACCESS_TOKEN is set (it is not validated against the API in this check, only for presence).

Output

management API: ready
endpoint: configured
access token: configured

If the API is unreachable:

management API readiness returned HTTP 503

Configuration

Variable Required Description
SCRIBASE_API_URL Yes Base URL of the management API
SCRIBASE_ACCESS_TOKEN No Token presence is reported but not required for doctor

Notes

doctor does not authenticate. It calls /health/ready without a bearer token so it can distinguish a reachable-but-unauthenticated failure from a network-level failure. Use it as a first step when debugging connectivity problems.