Save a password, API key or ID once and choose exactly which apps and agents may use it. The value is encrypted and never shown to the AI.
Say your clinic uses an invoicing service, and three apps and two agents all need its API key. Instead of typing the key into each one, save it once as a global secret and share it with the ones that need it. Open the account menu, then Developers, then Global Secrets, or go to /global-secrets. A secret that belongs to one app only can stay in that app's own Secrets screen.
1. Click New secret: Fill the name (for example GREEN_INVOICE_API_KEY), the Secret value and, if you like, a short description of what it is for. The eye button shows or hides the value while you type. Click Save secret.
2. Share it: A new secret is shared with nobody. On its row click Share. The window has two tabs, Agents and Apps. Tick the ones that may use the secret, or Select all, and click Save. The row then says how many agents and apps it is shared with.
Select all means the ones you have now: Sharing is a list of specific agents and apps. An agent or app you create later is not on it until you tick it in Share.
Who | How they get the secret
Agents | An agent reads a shared secret with its secret_get tool, by name. The AI only ever sees the name, never the value.
Apps | Shared secrets are added on their own to the app's server functions, like the app's own secrets.
To delete a secret click the bin on its row and confirm. Agents and apps that used it lose access at once, so check what depends on it first.
Q: Can I see a secret's value after saving it?
A: No. Values are stored encrypted and are never shown again, to you or to the AI. To change one, save it again or delete it and add it anew.
Q: What is the difference from app secrets?
A: App secrets belong to one app. A global secret is saved once on the account and shared with any agents and apps you pick.
Q: An agent says it cannot find the key.
A: Open Share on that secret and check that the agent is ticked on the Agents tab.
Related: Secrets: keys for outside services, API keys for your account, Connect your services (Connections), What an AI agent is