> ## Documentation Index
> Fetch the complete documentation index at: https://kmerhosting.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API keys

> Create and manage KmerHosting API keys without exposing customer session cookies.

API keys are created from the Account section of the customer console.

<Frame caption="The API-key tab shows named keys, status, creation time, and usage information.">
  <img src="https://mintcdn.com/kmerhosting-a736a8a9/qmzUGdL1AajWuhXn/images/screenshots/api-keys-list.png?fit=max&auto=format&n=qmzUGdL1AajWuhXn&q=85&s=9c45fcb124177fc9393f40223bfa4092" alt="The API-key tab shows named keys, status, creation time, and usage information." width="1600" height="900" data-path="images/screenshots/api-keys-list.png" />
</Frame>

## Create a key

1. Open Account and select the API Keys tab.
2. Enter a descriptive name such as `billing-report-production`.
3. Create the key.
4. Copy the complete value immediately.
5. Store it in a secret manager or protected environment variable.

<Frame caption="The complete key is shown only at creation and must be replaced with a redacted value before capture.">
  <img src="https://mintcdn.com/kmerhosting-a736a8a9/qmzUGdL1AajWuhXn/images/screenshots/api-key-created.png?fit=max&auto=format&n=qmzUGdL1AajWuhXn&q=85&s=a11c71cbe206f9bfa8e32121eabc9f1f" alt="The complete key is shown only at creation and must be replaced with a redacted value before capture." width="1600" height="900" data-path="images/screenshots/api-key-created.png" />
</Frame>

## Security model

* New keys use the `kh_live_` prefix.
* The complete key is returned only once.
* The platform stores a SHA-256 hash rather than the recoverable plaintext value.
* Keys can be deactivated, reactivated, and permanently deleted.
* The API rejects inactive or invalid keys.
* Usage and last-use information can be shown in the console.

<Frame caption="Usage visibility helps identify unexpected automation activity.">
  <img src="https://mintcdn.com/kmerhosting-a736a8a9/qmzUGdL1AajWuhXn/images/screenshots/api-key-usage.png?fit=max&auto=format&n=qmzUGdL1AajWuhXn&q=85&s=74e5fcf977c573866fcf6096bc924f90" alt="Usage visibility helps identify unexpected automation activity." width="1600" height="900" data-path="images/screenshots/api-key-usage.png" />
</Frame>

## Recommended scopes

The developer platform can distinguish account, service, domain, billing, order, notification, and AI Agent permissions. Grant only what the integration needs.

<Warning>
  Never place an API key in browser-side JavaScript, a public Git repository, a screenshot, or a support ticket.
</Warning>
