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

# Secrets

> Securely store encrypted credentials such as API keys and tokens for use by HTTP tools.

Secrets let you store sensitive values — API keys, tokens, and other credentials — that your [HTTP tools](/en/user-guide/tools/custom-tools) and [auth connections](/en/user-guide/settings/auth-connections) need. Secrets are stored encrypted, so you can reference them in tools without exposing the raw value. Open **Settings → Secrets** to manage them.

<Warning>
  Never share secret values, paste them into chat messages, or commit them to source control. Once stored, a secret's value is encrypted and not shown again — treat each secret as you would a password.
</Warning>

## Create a secret

<Steps>
  <Step title="Open Secrets">
    Open **Settings → Secrets** and select **Add secret**.
  </Step>

  <Step title="Name and value">
    Give the secret a clear name so you can recognize it later, then paste the credential value (such as an API key or token).
  </Step>

  <Step title="Save">
    Save the secret. homie encrypts the value and stores it securely. You can now reference it from an HTTP tool or auth connection.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/homieai/m0ZcYuq9OdpATfdE/images/Bildschirmfoto-2026-07-07-um-15.10.20.png?fit=max&auto=format&n=m0ZcYuq9OdpATfdE&q=85&s=61dc5a087f054a8f4f4c0bdcbe947bf6" alt="Bildschirmfoto 2026 07 07 Um 15 10 20" width="3024" height="1532" data-path="images/Bildschirmfoto-2026-07-07-um-15.10.20.png" />
</Frame>

{/* TODO: Screenshot — Dashboard > Settings > Secrets */}

## Edit and delete secrets

You can rename a secret or replace its value at any time — useful when you rotate a key. Deleting a secret removes it permanently; any HTTP tool that relies on it stops working until you provide a replacement.

<Note>
  Creating, editing, and deleting secrets requires the **Owner** or **Admin** role.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="HTTP Tool" icon="wrench" href="/en/user-guide/tools/custom-tools">
    Use stored secrets when building tools.
  </Card>

  <Card title="Auth connections" icon="link" href="/en/user-guide/settings/auth-connections">
    Connect external services with stored credentials.
  </Card>
</CardGroup>