@devries-cameron20 / composio Mirror · read-only / commits / 34d034dde
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 11:00 UTC

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.