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
CryogenicPlanet committed
Apr 14, 2026 at 02:12 UTC
c68b8e5486175e1ca78199dbda411d8e8c7ccc82
2 files changed
+39
-4
docs/content/reference/sdk-reference/python/connected-accounts.mdx
+37
-3
@@ -5,12 +5,44 @@ description: Manage connected accounts. This class is used to manage connected
5
6
## Methods
7
8
+### update()
9
+
10
+Update a connected account's alias and/or credentials.
11
+
12
+```python
13
+def update(nanoid: str, alias: str | None = ..., connection: connected_account_patch_params.Connection | None = ...) -> connected_account_patch_response.ConnectedAccountPatchRes...
14
+```
15
+
16
+**Parameters**
17
+
18
+| Name | Type |
19
+|------|------|
20
+| `nanoid` | `str` |
21
+| `alias?` | `str \| None` |
22
+| `connection?` | `connected_account_patch_params.Connection \| None` |
23
+
24
+**Returns**
25
+
26
+`connected_account_patch_response.ConnectedAccountPatchRes...` — Response with ``id``, ``status``, and ``success``.
27
+
28
+**Example**
29
+
30
+```python
31
+# Set an alias
32
+ composio.connected_accounts.update('ca_abc123', alias='work-gmail')
33
+
34
+ # Clear an alias
35
+ composio.connected_accounts.update('ca_abc123', alias='')
36
+```
37
+
38
+---
39
+
40
### initiate()
41
42
Compound function to create a new connected account. This function creates a new connected account and returns a connection request. Users can then wait for the connection to be established using the `wait_for_connection` method.
43
44
```python
13
-def initiate(user_id: str, auth_config_id: str, callback_url: str | None = ..., allow_multiple: bool = ..., config: connected_account_create_params.ConnectionState | None = ...) -> ConnectionRequest
45
+def initiate(user_id: str, auth_config_id: str, callback_url: str | None = ..., allow_multiple: bool = ..., config: connected_account_create_params.ConnectionState | None = ..., alias: str | None = ...) -> ConnectionRequest
46
```
47
48
**Parameters**
@@ -22,6 +54,7 @@ def initiate(user_id: str, auth_config_id: str, callback_url: str | None = ...,
54
| `callback_url?` | `str \| None` |
55
| `allow_multiple?` | `bool` |
56
| `config?` | `connected_account_create_params.ConnectionState \| None` |
57
+| `alias?` | `str \| None` |
58
59
**Returns**
60
@@ -34,7 +67,7 @@ def initiate(user_id: str, auth_config_id: str, callback_url: str | None = ...,
67
Create a Composio Connect Link for a user to connect their account to a given auth config. This method will return an external link which you can use for the user to connect their account.
68
69
```python
37
-def link(user_id: str, auth_config_id: str, callback_url: str | None = ...) -> ConnectionRequest
70
+def link(user_id: str, auth_config_id: str, callback_url: str | None = ..., alias: str | None = ...) -> ConnectionRequest
71
```
72
73
**Parameters**
@@ -44,6 +77,7 @@ def link(user_id: str, auth_config_id: str, callback_url: str | None = ...) -> C
77
| `user_id` | `str` |
78
| `auth_config_id` | `str` |
79
| `callback_url?` | `str \| None` |
80
+| `alias?` | `str \| None` |
81
82
**Returns**
83
@@ -96,4 +130,4 @@ def wait_for_connection(id: str, timeout: float | None = ...) -> connected_accou
130
131
---
132
99
-[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/connected_accounts.py#L318)
133
+[View source](https://github.com/composiohq/composio/blob/next/python/composio/core/models/connected_accounts.py#L321)
docs/content/reference/sdk-reference/python/tool-router-session.mdx
+2
-1
@@ -38,7 +38,7 @@ def tools(modifiers: 'Modifiers' | None = ...) -> TToolCollection
38
Authorize a toolkit for the user and get a connection request. Initiates the OAuth flow and returns a ConnectionRequest with redirect URL.
39
40
```python
41
-def authorize(toolkit: str, callback_url: str | None = ...) -> ConnectionRequest
41
+def authorize(toolkit: str, callback_url: str | None = ..., alias: str | None = ...) -> ConnectionRequest
42
```
43
44
**Parameters**
@@ -47,6 +47,7 @@ def authorize(toolkit: str, callback_url: str | None = ...) -> ConnectionRequest
47
|------|------|
48
| `toolkit` | `str` |
49
| `callback_url?` | `str \| None` |
50
+| `alias?` | `str \| None` |
51
52
**Returns**
53