Skip to main content

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

  1. Go to Organization → API Keys and click Generate New Key.
  2. Fill out the form:
    • Name — a label to help you identify the key later.
    • Scope — Read-only or Read-write.
  3. 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.