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: update documentation for new changelog entries (#4626)
## Summary Automated documentation updates triggered by new changelog entries merged to next. Generated by Codex via GitHub Actions. Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
sdkrelease[bot] committed
Sep 24, 2026 at 20:17 UTC
34d034ddeeba04f654ee730e93b17f96b27d3884
1 file changed
+12
docs/content/docs/instant-tools.mdx
+12
@@ -98,6 +98,18 @@ const result = await session.execute("EXA_SEARCH", { query: "Composio documentat
98
99
Check the current [tool input schema](/reference/api-reference/tools/getToolsByToolSlug) before constructing arguments. A tool appearing in a toolkit does not mean hosted account access is available for that tool. Confirm supported tools and rates during Experimental access.
100
101
+### Read charge details in Python
102
+
103
+With `premium_usage.return_premium_charge` enabled, `session.execute()` returns charge details when available in the typed `premium_charge` field on `ToolRouterSessionExecuteResponse`. Read it from the result above:
104
+
105
+```python
106
+charge = result.premium_charge
107
+if charge is not None:
108
+ print(charge["amount"], charge["currency"], charge["charged_by"])
109
+```
110
+
111
+The `PremiumCharge` type is exported from `composio.types` and includes `amount`, `currency`, and `charged_by`. Python provider integrations and mixed local/remote multi-tool execution also preserve these charge details.
112
+
113
## Control premium usage
114
115
`premium_usage` is a Session policy (`premiumUsage` in TypeScript). It does not enable a toolkit that top-level `toolkits` excludes, and it does not change a connected account you explicitly selected.