How to use Secrets in API tool from AI agent (not API block)
I can use the secrets on the API block, but it seems that I cannot find a way to use the secrets if I'm using the API tool inside an AI agent. Do anyone knows if this is possible? Thanks,
2 Replies
Yes – you can call your project Secrets from an API tool that lives inside an Agent step the same way you would in a stand-alone API block.
How to insert a secret
1. Make sure the secret already exists (Agent Settings → Secrets → New Secret).
2. Open the Agent step, click Add tool → API (or edit an existing API tool).
3. In any field that accepts a value – URL, header value, query string, request body, etc. – type the first curly brace
{.
4. The variable picker appears. At the top switch from Variables to Secrets and choose the secret you want.
5. Voiceflow will insert the placeholder {{YOUR_SECRET_NAME}}. When the agent runs, the real value (or the environment override) is injected, so the user never sees it.
Tips
• The picker will only show up after you have created at least one secret.
• Environment overrides you set in Agent Settings → Environments are also respected when the API tool executes inside the Agent.
• If you still don’t see the dropdown, double-check that you are typing the brace inside a value field (not the key/label column).
Docs: https://docs.voiceflow.com/docs/secrets → “Using Secrets in Function and API Steps”
So you don’t need a separate API block – just drop the secret into the API tool inside your Agent and it will resolve at runtime.
