How to manage secrets

Last updated October 14, 2026

Who can use this feature?
Admins only.
Availability depends on your Atlas plan.

Overview

Secrets let you store sensitive values, such as API keys and other credentials, securely in Atlas. Each secret is a key-value pair: a key that identifies the secret and a value that is entered in a masked password field. Keeping credentials in "Secrets" helps you control sensitive authentication data in one place instead of sharing it in plain text.

Secrets are a global setup: an Admin manages them once for the whole workspace.

Related articles:
• How to create and manage API templates: Set up reusable API requests.
• Learn about blocks in chatbots/workflows: Where API requests are used.

Key Features

Key-value storage: Store each credential as a key and a value.
Masked values: The value is entered in a password field, so it is hidden while you type. Use the show/hide icon in the field to check what you entered.
Secrets list: The "Secrets" page lists each secret with its "Key", "Value", and "Created on" date, and includes a "Filter..." search.
Delete with confirmation: Remove a secret from the Actions menu on its row and confirm with "OK".

How to create a secret

Use this guide to store a new credential in Atlas.

Requirements:
You have the credential you want to store, for example an API key from an external system.

Go to "App Configuration > Data > Secrets" .
Click "Add secret".
Configure the fields:

Key: Enter a name that identifies the secret, for example ACME_API_KEY.
Value (required): Enter the secret value in the password field ("Enter value"). Click the show icon if you need to check what you typed.

Click "Create".

The new secret appears in the "Secrets" list.

Important:
Never share secret values in tickets or screenshots. Use a clear key name so teammates know what it is.

How to edit a secret

To change a secret value, delete the secret and create it again with the new value.

How to delete a secret

Go to "App Configuration > Data > Secrets" .
Locate the secret and open the Actions menu at the end of its row.
Select "Delete".
Click "OK" to confirm. The secret is removed from the "Secrets" list.

Important:
Before deleting a secret, make sure nothing in Atlas still depends on it.

FAQs & Troubleshooting

Where do I find secrets?

Go to "App Configuration > Data > Secrets" .

Can I see a secret value after I enter it?

While you type, you can use the show icon in the value field to check the value.

How do I find a specific secret?

Use the "Filter..." search on the "Secrets" page, or sort by "Key".

Was this article helpful?

Table of contents