Approve in chat
When your AI Agent needs to use a tool that requires approval, an approval card appears in the conversation. This guide shows you what the card looks like and how to act on it.
The approval card
When approval is needed, a card appears in the chat showing:
- The tool your AI Agent wants to run (for example Web Scraper, Create Contact).
- The input the tool will receive.
- Two buttons: Approve and Dismiss.
Approve a tool call
Click Approve.
What happens next:
- The button briefly shows Processing….
- The tool executes with the input you saw.
- The card updates to an Approved badge.
- Your AI Agent continues the conversation using the tool's output.
Your AI Agent picks up right where it left off — no need to repeat your request.
Approving a destructive tool call (send email, create/update CRM records, delete data, call a webhook) runs the action immediately. It cannot be undone. Review the input before clicking Approve.
Dismiss a tool call
Click Dismiss.
A feedback area appears with a placeholder that reads "Optional: Why are you dismissing this tool?". Typing feedback is optional.
Click Confirm Dismiss to confirm (or Cancel to go back to the approval buttons).
What happens next:
- The card updates to a Dismissed badge.
- The tool does not run.
- Your AI Agent continues without the tool's result. It may adjust its approach or ask you for guidance.
Feedback is optional but helpful. If you tell your AI Agent why you dismissed (for example "Wrong URL" or "Don't contact this person"), it can adjust in the same conversation without you rewriting the whole request.
Multiple approvals at once
Your AI Agent may need approval for several tools in the same turn. Each tool gets its own card. You can approve or dismiss them in any order. Your AI Agent continues once all pending approvals are resolved.
Approvals from a subagent
If your AI Agent calls another AI Agent (using the AI Agent tool), and that subagent's tool needs approval, you still see the approval card in your main chat — not in a hidden subagent conversation.
The flow works the same way:
- Your AI Agent calls a subagent.
- The subagent tries to use a tool that needs approval.
- You see the approval card in your main chat.
- You approve or dismiss.
- The subagent completes its work and returns the result to the parent AI Agent.
This works at any nesting level. See Subagent approvals for more.
FAQ
Can I undo an approval? No. Once you approve, the tool runs immediately. Review the input carefully before approving.
What if I close the chat without approving? The approval waits for you. When you return to the conversation, the pending card is still there and you can decide then. You can also review it from the Pending Approvals view.
Can multiple tools need approval at the same time? Yes. Each gets its own card. Approve or dismiss them individually.
Does my AI Agent stop completely while waiting? Not entirely. Your AI Agent finishes its current response, but it cannot use that tool's result until you decide. Once all pending tools are resolved, the conversation resumes automatically.
Can I change which tools require approval later? Yes. Go to your AI Agent → Tools, edit the tool, and toggle the checkbox. Changes take effect for new conversations. See Enable tool approval.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| No approval card appears | The tool doesn't have Requires Human Approval Before Execution enabled. | Turn it on in the tool's configuration. |
| Card appears but doesn't respond | The approval was already resolved elsewhere (another browser tab or session). | Refresh the page. |
| AI Agent doesn't continue after approval | Your AI Agent is waiting for other pending approvals. | Check for more cards in the conversation, or open Pending Approvals. |
| Tool failed after approval | The tool hit an error during execution (API down, invalid data, etc.). | Check the error in the card and retry or adjust your request. |
For deeper troubleshooting, see Troubleshoot stuck tasks.