Managing secrets

When writing custom functions, you might need to reference sensitive information such as API keys or login credentials. Using secrets, organizations can centrally define and manage these sensitive values.

Members of selected workspaces can then reference secrets in custom functions used in Build apps and deployments.

Creating secrets

Organization admins can create and manage secrets.

1. In the header, click the initials icon and select Settings.

2. Click Secrets.

3. Click Add secret.

4. Configure the secret.

   • Name: A name for the secret. Names can contain alphanumeric characters or underscores and can’t be changed after saving.

     This name is what members see when adding secret keys to their custom functions. Use a brief but descriptive name that helps members identify the secret and its intended usage.

   • Value: The secret value itself, up to 45,000 characters in length. After saving, the input is encrypted and can’t be viewed again.

   • Workspaces: Which workspaces the secret is available to. To make the secret available to only some workspaces, use the input field to select from a list of all shared workspaces.

     All workspaces makes the secret available in both shared and personal workspaces.

   • Description: Optional notes or details about the secret and its usage.

5. Click Add secret.

Updating secrets

After creating a secret, you can update its value, workspace availability, and description. You can’t view a secret’s current value.

1. In the header, click the initials icon and select Settings.

2. Click Secrets to view the secrets list.

3. In the secret’s row, click the edit icon.

4. Edit the secret’s value or other settings, then click Save.

Deleting secrets

Deleting a secret deletes its value, affecting any custom functions that reference the secret. For your convenience, when deleting a secret, the confirmation modal lists any deployments in which the secret is referenced.

1. In the header, click the initials icon and select Settings.

2. Click Secrets to view the secrets list.

3. In the secret’s row, click the delete icon .

4. Click Delete to confirm.