@devries-cameron20 / composio-1 / commits / 01eee403e
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs(tool-hints): explain idempotentHint repeat calls (#5328)

## Summary Documents what `idempotentHint` promises, per https://github.com/ComposioHQ/mercury/issues/30412: no further effect on repeat, not a guaranteed success. Designated PR reviewer: @jkomyno ## Changes - New "Repeat calls" section on the Tool hints page - `idempotentHint` added to the page keywords ## Type of change - [x] Documentation ## How Has This Been Tested? Docs-only. Site not built locally; the linked KB page exists on `next`. ## Checklist - [ ] I have read the Code of Conduct and this PR adheres to it - [ ] I have read and understand every line of this diff, including any LLM-generated code - [x] Any third-party docs links or promotional content follow the third-party links policy - [ ] I ran linters/tests locally and they passed - [x] I updated documentation as needed - [x] I added tests or explain why not applicable - [x] I added a changeset if this change affects published packages 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Rayane Boussanni committed Nov 12, 2026 at 12:27 UTC 01eee403eea31ef7dcb1ed6b0bcb90d688f335b7
1 file changed +7 -1
docs/content/docs/governance/tool-hints.mdx
+7 -1
@@ -1,7 +1,7 @@
1 ---
2 title: Tool hints
3 description: How Composio classifies each tool by the action it takes, and how sessions use those hints
4 -keywords: [tags, readOnlyHint, createHint, updateHint, destructiveHint, governance, permissions]
4 +keywords: [tags, readOnlyHint, createHint, updateHint, destructiveHint, idempotentHint, governance, permissions]
5 ---
6
7 Every tool has a **hint** that describes the action it takes: reading, creating, updating or deleting. In [sessions](/docs/configuring-sessions), you can use these hints to configure the tools available in the session.
@@ -23,6 +23,12 @@ Every tool has a **hint** that describes the action it takes: reading, creating,
23
24 Composio assigns hints on a best-effort basis, based on each tool's description and behavior. For MCP tools, Composio infers them from the tool's description and the hints the MCP server provides.
25
26 +<span id="idempotent-hint" className="block scroll-m-28" />
27 +
28 +## Repeat calls
29 +
30 +Some tools also have `idempotentHint`. As in MCP, it means calling the tool again with the same arguments has no further effect. It doesn't mean the repeat succeeds: deleting something twice can return a "not found" error the second time. After a timeout, check the [execution log](/kb/guide/sdk-tool-execution-retries) before you retry.
31 +
32 <span id="using-tags-in-a-session" className="block scroll-m-28" />
33
34 ## Using hints in a session