Skip to main content
Keys for the Hollerith API live in the console. To view your existing keys or create a new one, go to API Keys.
1

Sign in to the console

2

Open the API Keys page

Select API Keys in the sidebar, or go straight to hollerith.monarcha.ai/dashboard/keys.
3

Create a key

Click Create API Key, then give the key a name. You can also choose an expiration period.
4

Copy and store the key

The console shows the full key, which starts with hk_live_, only at creation. Copy it and store it somewhere safe, such as a secrets manager. If you lose a key, revoke it and create a new one instead.
A key stays valid until you revoke it or it expires. Protect your keys like passwords; anyone with access can submit jobs billed to your organization.

Use your API key

Set the key as an environment variable:
The SDK reads it from there. Direct HTTP requests send the key in the Authorization: Bearer header. To make your first prediction, follow the Quickstart guide.

Revoke a key

Revoke a key on the API Keys page. It stops authenticating immediately. A key given an expiration at creation stops authenticating once that date passes and returns expired_api_key. Keys created without one never expire.
Revoking is not reversible, and no key can be shown again after creation. To get a usable key, create a new one in API Keys in the console.

Next steps

Quickstart

Make your first API call to Hollerith

Errors

Hollerith errors and their causes