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

# API Keys

> Create and manage keys for the Engramme API

API keys are created in [app.engramme.com](https://app.engramme.com). Use them to call the public memory API with the `x-api-key` header.

## Create a Key

<Steps>
  <Step title="Sign in">
    Sign in to the Engramme app with Google.
  </Step>

  <Step title="Open API key management">
    Create a new key with a name and billing account.
  </Step>

  <Step title="Choose source access">
    Select the source access mode for the key. See [Source Access](/console-setup/source-access) for details.
  </Step>

  <Step title="Copy the key">
    New keys are shown once. Store the value in a password manager or secret manager before closing the dialog.
  </Step>
</Steps>

## Key Behavior

* You can create up to 5 API keys.
* The default key cannot be deleted, but it can be regenerated.
* New keys require a billing account.
* Source-scoped keys can only access selected source types. See [Source Access](/console-setup/source-access).
* Key names must be 63 characters or fewer and use lowercase letters, numbers, hyphens, or underscores.

<Note>
  During onboarding, the app may create an initial key for you. In the API key management page, new custom keys require a name.
</Note>

## Use a Key

```bash theme={null}
export ENGRAMME_API_KEY="YOUR_API_KEY"

curl -X POST https://memorymachines-gateway-prod-btf57kda.uc.gateway.dev/v1/memories/recall \
  -H "x-api-key: $ENGRAMME_API_KEY" \
  -F "text=team meetings"
```

<Warning>
  API keys are secrets. Do not expose them in browser JavaScript or commit them to source control.
</Warning>
