Skip to content

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: auto-generate Python SDK reference

jkomyno2319d725b3df
diff --git a/docs/content/reference/sdk-reference/python/composio.mdx b/docs/content/reference/sdk-reference/python/composio.mdx
index 3c4934703..965b8602e 100644
--- a/docs/content/reference/sdk-reference/python/composio.mdx
+++ b/docs/content/reference/sdk-reference/python/composio.mdx
@@ -1,6 +1,6 @@
---
title: Composio
-description: Composio SDK for Python.
+description: "Composio SDK for Python. Generic parameters: TTool: The individual tool type returned by the provider (e.g., ChatCompletionToolParam for OpenAI). ..."
---
## Properties
@@ -14,4 +14,4 @@ description: Composio SDK for Python.
| [`connected_accounts`](/reference/sdk-reference/python/connected-accounts) | `ConnectedAccounts` |
| [`mcp`](/reference/sdk-reference/python/mcp) | `MCP` |
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L53)
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/sdk.py#L46)
diff --git a/docs/content/reference/sdk-reference/python/index.mdx b/docs/content/reference/sdk-reference/python/index.mdx
index 2aa6f8405..dd26dc36e 100644
--- a/docs/content/reference/sdk-reference/python/index.mdx
+++ b/docs/content/reference/sdk-reference/python/index.mdx
@@ -23,7 +23,7 @@ uv add composio
| Class | Description |
|-------|-------------|
-| [`Composio`](/reference/sdk-reference/python/composio) | Composio SDK for Python. |
+| [`Composio`](/reference/sdk-reference/python/composio) | Composio SDK for Python. Generic parameters: TTool: The individual tool type re... |
| [`Tools`](/reference/sdk-reference/python/tools) | Tools class definition This class is used to manage tools in the Composio SDK. ... |
| [`Toolkits`](/reference/sdk-reference/python/toolkits) | Toolkits are a collectiono of tools that can be used to perform various tasks. T... |
| [`Triggers`](/reference/sdk-reference/python/triggers) | Triggers (instance) class |
diff --git a/docs/content/reference/sdk-reference/python/tools.mdx b/docs/content/reference/sdk-reference/python/tools.mdx
index cd25224a6..3c84c055c 100644
--- a/docs/content/reference/sdk-reference/python/tools.mdx
+++ b/docs/content/reference/sdk-reference/python/tools.mdx
@@ -1,6 +1,6 @@
---
title: Tools
-description: Tools class definition This class is used to manage tools in the Composio SDK. It provides methods to list, get, and execute tools.
+description: Tools class definition This class is used to manage tools in the Composio SDK. It provides methods to list, get, and execute tools. Generic Param...
---
## Methods
@@ -101,10 +101,10 @@ def get_raw_tool_router_meta_tools(session_id: str, modifiers: 'Modifiers' | Non
### get()
-Get a tool or list of tools based on the provided arguments.
+Get a tool or list of tools based on the provided arguments. The return type is automatically inferred based on the provider's generic parameters. For example: - OpenAIProvider -> list[ChatCompletionToolParam] - AnthropicProvider -> list[ToolParam] - CustomProvider[MyTool, list[MyTool]] -> list[MyTool]
```python
-def get(user_id: str, slug: str | None = ..., tools: list[str | None] = ..., search: str | None = ..., toolkits: list[str | None] = ..., scopes: List[str | None] = ..., modifiers: Modifiers | None = ..., limit: int | None = ...)
+def get(user_id: str, slug: str | None = ..., tools: list[str | None] = ..., search: str | None = ..., toolkits: list[str | None] = ..., scopes: List[str | None] = ..., modifiers: Modifiers | None = ..., limit: int | None = ...) -> TToolCollection
```
**Parameters**
@@ -120,6 +120,10 @@ def get(user_id: str, slug: str | None = ..., tools: list[str | None] = ..., sea
| `modifiers?` | `Modifiers \| None` |
| `limit?` | `int \| None` |
+**Returns**
+
+`TToolCollection` — Provider-specific tool collection (TToolCollection).
+
---
### execute()
@@ -176,4 +180,4 @@ def proxy(endpoint: str, method: Literal['GET', 'POST', 'PUT', 'DELETE', 'PATCH'
---
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L48)
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/tools.py#L45)
diff --git a/docs/content/reference/sdk-reference/python/triggers.mdx b/docs/content/reference/sdk-reference/python/triggers.mdx
index 9e140d2c2..b704b6511 100644
--- a/docs/content/reference/sdk-reference/python/triggers.mdx
+++ b/docs/content/reference/sdk-reference/python/triggers.mdx
@@ -156,4 +156,4 @@ def verify_webhook(id: str, payload: str, secret: str, signature: str, timestamp
---
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L689)
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/triggers.py#L701)