API Keys
API keys let you authenticate against the HoundER API outside of the platform UI — for scripts, integrations, or CI/CD pipelines. This is Organization Admin-only functionality.
Creating a key
- Go to Organization → API Keys and click Generate New Key.
- Fill out the form:
- Name — a label to help you identify the key later.
- Scope — Read-only or Read-write.
- Submit to generate the key. The full key and secret are shown once, immediately after creation — copy them somewhere safe, since they can't be retrieved again afterward.
Scoping
Each key is created with one of two scopes:
- Read-only — can query data, but can't create, edit, or delete anything.
- Read-write — can perform the same actions as the user who created it, through the API.
Scope is fixed at creation; to change a key's scope, revoke it and create a new one.
Revoking a key
From the API Keys list, select one or more keys and revoke them. Revocation is immediate and can't be undone — any scripts or integrations using that key will start failing authentication right away.
Your organization's subscription plan limits the number of active API keys; usage is shown on the Settings page.