Skip to main content
Every request to Hollerith is authenticated with an API key scoped to your organization.

Create a key

  1. Sign in to the console.
  2. Open API Keys → Create.
  3. Copy the key (hk_live_...). It is shown once and never again. Store it in a secret manager or your shell environment.
The plaintext key is displayed exactly once at creation. If you lose it, revoke it and create a new one.

Configure the client

The SDK reads two environment variables:
export HOLLERITH_API_KEY="hk_live_…"
export HOLLERITH_BASE_URL="https://hollerith.monarcha.ai"
Or pass them explicitly:
from hollerith import Hollerith

clf = Hollerith(
    api_key="hk_live_…",
    base_url="https://hollerith.monarcha.ai",
)

Rotate or revoke

In API Keys, revoke a key to disable it immediately, then create a replacement. Revoked keys are kept (not deleted) so the last-used audit trail survives.

Errors are traceable

Every API error carries a requestId (the SDK surfaces it on the exception). Quote it to support and we can find the exact server log.