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

# Secrets

> Manage organization secrets for Beam pipelines and integrations.

Store credentials and sensitive values for use in [Beam pipelines](/beam/overview) and integrations. Only organization admins can manage secrets.

## Create a secret

<Steps>
  <Step title="Navigate to Secrets settings">
    Open [**Settings → Secrets**](https://app.allium.so/settings/secrets).

    <Frame>
      <img src="https://mintcdn.com/allium-e770e2b7/gBPCIPWTCYl0J6SH/images/secrets-settings.png?fit=max&auto=format&n=gBPCIPWTCYl0J6SH&q=85&s=935e52d02536b20e6b640bb07ea371ad" alt="Secrets settings page" width="1135" height="880" data-path="images/secrets-settings.png" />
    </Frame>
  </Step>

  <Step title="Create a new secret">
    Click **Create**, enter a **name** and **value**, then click **Save**.

    <Frame>
      <img src="https://mintcdn.com/allium-e770e2b7/gBPCIPWTCYl0J6SH/images/secrets-create.png?fit=max&auto=format&n=gBPCIPWTCYl0J6SH&q=85&s=1a7ea195c9f92bf911ce90bf9bcde27c" alt="Create secret dialog" width="787" height="402" data-path="images/secrets-create.png" />
    </Frame>
  </Step>
</Steps>

## Update a secret

<Steps>
  <Step title="Find the secret">
    Open [**Settings → Secrets**](https://app.allium.so/settings/secrets) and locate the secret you want to update.
  </Step>

  <Step title="Edit the value">
    Click the secret's edit button, enter the new value, and click **Update**.

    <Frame>
      <img src="https://mintcdn.com/allium-e770e2b7/gBPCIPWTCYl0J6SH/images/secrets-update.png?fit=max&auto=format&n=gBPCIPWTCYl0J6SH&q=85&s=ddfbd5126b83edc36f91b28f4a7f7389" alt="Update secret dialog" width="739" height="418" data-path="images/secrets-update.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Updating a secret does not automatically propagate to running Beam pipelines. You must **redeploy** any dependent pipelines for the new value to take effect.
</Warning>

## Delete a secret

<Steps>
  <Step title="Find the secret">
    Open [**Settings → Secrets**](https://app.allium.so/settings/secrets) and locate the secret you want to delete.
  </Step>

  <Step title="Delete and confirm">
    Click the secret's delete button and confirm the deletion.
  </Step>
</Steps>

<Warning>
  Deleting a secret will cause any Beam pipelines or integrations that reference it to **fail**. Make sure no active resources depend on the secret before deleting.
</Warning>

## Permissions

| Role       | Access                                     |
| :--------- | :----------------------------------------- |
| **Admin**  | Full access — create, read, update, delete |
| **Member** | No access                                  |
| **Viewer** | No access                                  |
