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 22, 13:15 UTC
docs: sync January changelog files from fern
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh committed
Jan 24, 2026 at 01:57 UTC
2ebec7621709ab60a55dbbb80ff4e5a62491cae3
9 files changed
+382
-124
docs/content/changelog/01-07-26.mdx
+10
-13
@@ -1,20 +1,20 @@
1
---
2
-title: "Consistent Error Response Structure & Union Types Preserved"
2
+title: "Consistent Error Response Structure"
3
date: "2026-01-07"
4
---
5
6
-## Consistent Error Response Structure
6
+# Consistent Error Response Structure
7
8
Tool execution errors now return a standardized response format across all failure types. Previously, the `data` field was empty on errors—now it always includes `status_code` and `message`, matching the structure of successful responses.
9
10
-### What Changed
10
+## What Changed
11
12
All error responses from tool execution now include:
13
- `data.status_code`: HTTP status code (or `null` for non-HTTP errors)
14
- `data.message`: Detailed error message
15
- `error`: Same detailed message at the top level
16
17
-### Before vs After
17
+## Before vs After
18
19
**Previous error response:**
20
```json
@@ -38,7 +38,7 @@ All error responses from tool execution now include:
38
}
39
```
40
41
-### Why This Matters
41
+## Why This Matters
42
43
- **Easier parsing**: Agents and code can reliably access error details from `data.message` without special-casing empty `data` objects
44
- **Better debugging**: Detailed error messages replace generic HTTP error strings
@@ -46,11 +46,11 @@ All error responses from tool execution now include:
46
47
---
48
49
-## Union Types Preserved in Tool Schemas
49
+# Union Types Preserved in Tool Schemas
50
51
Tool schemas now use standard JSON Schema `anyOf` for union types, providing accurate type information for LLMs and code generators.
52
53
-### What Changed
53
+## What Changed
54
55
Two changes affect how types appear in request/response schemas:
56
@@ -59,7 +59,6 @@ Two changes affect how types appear in request/response schemas:
59
| **Nullable fields** | **All toolkits** | Fields that accept `null` now use `anyOf: [{type}, {type: "null"}]` instead of `type` + `nullable: true` |
60
| **Multi-type fields** | 157 toolkits | Fields accepting multiple value types (e.g., `string \| number`) preserve the full `anyOf` array instead of flattening to the first type |
61
62
-<Accordions>
62
<Accordion title="Toolkits with multi-type union fields (157 total)">
63
64
### CRM & Sales
@@ -111,11 +110,9 @@ clearout, icypeas, neverbounce, zerobounce
110
bitwarden, canny, cardly, castingwords, confluence, formdesk, getform, habitica, headout, highergov, jira, keen_io, landbot, moonclerk, one_drive, outlook, googlesheets, resend, ritekit, sms_alert, tapfiliate, thanks_io, uptimerobot
111
112
</Accordion>
114
-</Accordions>
113
116
-### Before vs After
114
+## Before vs After
115
For example, the `GOOGLECALENDAR_GET_CURRENT_DATE_TIME` request schema changes:
118
-
116
**Previous (only a single type):**
117
```json
118
{
@@ -173,7 +170,7 @@ Similarly, nullable fields like `page_token` in `GOOGLECALENDAR_LIST_CALENDARS`:
170
}
171
```
172
176
-### Why This Matters
173
+## Why This Matters
174
175
- **Accurate schemas**: LLMs and code generators see the full set of allowed types
179
-- **Better validation**: Input validation can now correctly accept all valid types, not just the first one
176
+- **Better validation**: Input validation can now correctly accept all valid types, not just the first one
\ No newline at end of file
docs/content/changelog/01-08-26-mcp-api-key-enforcement.mdx
+10
-3
@@ -3,11 +3,13 @@ title: "Optional API Key Enforcement for MCP Servers"
3
date: "2026-01-08"
4
---
5
6
+# Optional API Key Enforcement for MCP Servers
7
+
8
We've introduced a new project-level security setting that allows you to require API key authentication for all MCP server requests. This opt-in feature gives you fine-grained control over who can access your MCP endpoints.
9
8
-<Callout type="info">
10
+<Note>
11
**Opt-in today, default soon**: This feature is currently opt-in. Starting **March 1, 2026**, it will be enabled by default for new organizations. We recommend enabling it now to prepare your integrations.
10
-</Callout>
12
+</Note>
13
14
## What's New
15
@@ -58,6 +60,10 @@ curl -X POST "https://mcp.composio.dev/{your_mcp_server_url}" \
60
3. Find the **"Require API Key for MCP"** toggle
61
4. Enable the toggle
62
63
+<Frame>
64
+ <img src="/assets/images/mcp-api-key-toggle.png" alt="MCP API Key Toggle in Project Settings" />
65
+</Frame>
66
+
67
### Via API
68
69
Update your project configuration using the API:
@@ -81,6 +87,7 @@ curl -X PATCH "https://backend.composio.dev/api/v3/org/project/config" \
87
88
### Via Code
89
90
+<CodeGroup>
91
```python title="Python"
92
import requests
93
@@ -95,7 +102,6 @@ response = requests.patch(
102
103
print(response.json())
104
```
98
-
105
```typescript title="TypeScript"
106
const response = await fetch(
107
"https://backend.composio.dev/api/v3/org/project/config",
@@ -111,6 +117,7 @@ const response = await fetch(
117
118
console.log(await response.json());
119
```
120
+</CodeGroup>
121
122
## When to Use This
123
docs/content/changelog/01-09-26.mdx
+104
-5
@@ -3,6 +3,8 @@ title: "Tool Enum Name Shortening"
3
date: "2026-01-09"
4
---
5
6
+# Tool Enum Name Shortening
7
+
8
Shortened tool enum names across 181 actions to ensure compatibility with all AI agent frameworks.
9
10
## Why This Change?
@@ -13,8 +15,8 @@ Some agent frameworks have a **64-character limit** on tool/function names. Seve
15
16
**This change will not break your integration if you are using `latest` toolkit versions** or fetching tools dynamically. The SDK automatically resolves the correct tool names.
17
16
-<Accordions>
17
-<Accordion title="View All Enum Changes (181 tools)">
18
+<details>
19
+<summary><strong>View All Enum Changes (181 tools)</strong></summary>
20
21
| Old Enum | New Enum |
22
|----------|----------|
@@ -100,10 +102,107 @@ Some agent frameworks have a **64-character limit** on tool/function names. Seve
102
| `DEPLOYHQ_DELETE_PROJECTS_PROJECT_BUILD_CACHE_FILES_IDENTIFIER` | `DEPLOYHQ_DELETE_PROJECTS_PROJECT_BUILD_CACHE_FILES` |
103
| `DROPBOX_SIGN_EDIT_AND_RESEND_EMBEDDED_SIGNATURE_REQUEST_WITH_TEMPLATE` | `DROPBOX_SIGN_EDIT_RESEND_EMBEDDED_SIGNATURE_REQUEST_TEMPLATE` |
104
| `GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION` | `GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORG` |
103
-| ... and 100+ more |
105
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_BIG_QUERY_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_BIG_QUERY_LINKS` |
106
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CHANNELGROUPS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CHANNELGROUPS` |
107
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CONVERSIONEVENTS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CONVERSIONEVENTS` |
108
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CUSTOMDIMENSIONS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CUSTOMDIMENSIONS` |
109
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_DATASTREAMS_MEASUREMENTPROTOCOLSECRETS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_DATASTREAMS` |
110
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_DISPLAY_VIDEO360_ADVERTISER_LINK_PROPOSALS_LIST` | `GOOGLE_ANALYTICS_ADMIN_PROPS_DV360_LINK_PROPOSALS_LIST` |
111
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_DISPLAY_VIDEO360_ADVERTISER_LINKS_LIST` | `GOOGLE_ANALYTICS_ADMIN_PROPS_DV360_AD_LINKS_LIST` |
112
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_EXPANDEDDATASETS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_EXPANDEDDATASETS` |
113
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_FIREBASELINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_FIREBASELINKS` |
114
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS` |
115
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_SEARCH_ADS360_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_SEARCH_ADS360` |
116
+| `GOOGLE_ANALYTICS_PROPERTIES_DATASTREAMS_EVENTCREATERULES_LIST_ACTION` | `GOOGLE_ANALYTICS_PROPERTIES_DATASTREAMS_EVENTCREATERULES` |
117
+| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_DELETE` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_DELETE` |
118
+| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_GET` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_GET` |
119
+| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_LIST` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_LIST` |
120
+| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_ADD_ON_ATTACHMENTS_DELETE` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_ADD_ON_ATTACHS_DELETE` |
121
+| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_ADD_ON_ATTACHMENTS_LIST` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_ADD_ATTACHS` |
122
+| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_GET_ADD_ON_CONTEXT` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_GET_ADD` |
123
+| `INSTANTLY_DFY_EMAIL_ACCOUNT_ORDERS_DOMAINS_PRE_WARMED_UP_LIST_POST` | `INSTANTLY_DFY_EMAIL_ACCOUNT_ORDERS_DOMAINS_PRE_WARMED_UP` |
124
+| `INSTANTLY_LIST_INBOX_PLACEMENT_BLACKLIST_AND_SPAM_ASSASSIN_REPORTS` | `INSTANTLY_LIST_INBOX_PLACEMENT_BLACKLIST_SPAM_ASSASSIN` |
125
+| `METABASE_DELETE_API_USER_KEY_VALUE_NAMESPACE_NAMESPACE_KEY_KEY` | `METABASE_DELETE_API_USER_KEY_VALUE_NAMESPACE_NAMESPACE_KEY` |
126
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_DATABASE_ID_CANDIDATES` | `METABASE_GET_API_AUTO_DASHBOARDS_DATABASE_ID_CANDIDATES` |
127
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_CELL_CELL_QUERY` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_CELL_QUERY` |
128
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_CELL_CELL_QUERY_RULE_PREFIX` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_CELL_QUERY_RULE` |
129
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_QUERY_METADATA` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_QUERY_METADATA` |
130
+| `METABASE_GET_API_DASHBOARD_ID_PARAMS_PARAM_KEY_REMAPPING` | `METABASE_GET_API_DASH_ID_PARAMS_PARAM_KEY_REMAPPING` |
131
+| `METABASE_GET_API_DASHBOARD_ID_PARAMS_PARAM_KEY_VALUES` | `METABASE_GET_API_DASH_ID_PARAMS_PARAM_KEY_VALUES` |
132
+| `METABASE_POST_API_DASHBOARD_SAVE_COLLECTION_PARENT_COLLECTION_ID` | `METABASE_POST_API_DASH_SAVE_COLLECTION_PARENT_COLLECTION_ID` |
133
+| `METABASE_POST_API_EE_METABOT_TOOLS_CREATE_DASHBOARD_SUBSCRIPTION` | `METABASE_POST_API_EE_METABOT_TOOLS_CREATE_DASH_SUB` |
134
+| `METABASE_POST_API_EE_METABOT_TOOLS_GET_DASHBOARD_DETAILS` | `METABASE_POST_API_EE_METABOT_TOOLS_GET_DASH_DETAILS` |
135
+| `METABASE_POST_API_EE_METABOT_TOOLS_GET_DOCUMENT_DETAILS` | `METABASE_POST_API_EE_METABOT_TOOLS_GET_DOC_DETAILS` |
136
+| `SALESFORCE_GET_VALUES_FOR_ALL_PICKLIST_FIELDS_OF_A_RECORD_TYPE` | `SALESFORCE_GET_PICKLIST_VALUES_BY_RECORD_TYPE` |
137
+| `SALESFORCE_GET_UIAPI_LIST_INFO_ACCOUNT_RECENT_LISTS_ONLY_TRUE` | `SALESFORCE_GET_UI_API_LIST_INFO_RECENT` |
138
+| `SALESFORCE_GET_UIAPI_RELATED_LIST_PREFERENCES_BATCH_ACCOUNTRELATEDCONTACTLISTACCOUNTRELATEDOPPORTUNITYLIST` | `SALESFORCE_GET_RELATED_LIST_PREFS_BATCH` |
139
+| `SALESFORCE_SERVICE_CLOUD_VISITOR_SENSITIVE_DATA_RULE_TRIGGERED` | `SALESFORCE_SERVICE_CLOUD_VISITOR_SENSITIVE_DATA_RULE` |
140
+| `SAP_SUCCESSFACTORS_CREATE_OR_UPDATE_A_SUCCESSOR_NOMINATION_FOR_A_POSITION_OR_TALENT_POOL` | `SAP_SUCCESSFACTORS_CREATE_UPDATE_SUCCESSOR_NOMINATION` |
141
+| `SAP_SUCCESSFACTORS_DELETE_A_NOMINATION_FOR_A_POSITION_OR_TALENT_POOL` | `SAP_SUCCESSFACTORS_DELETE_NOMINATION_POSITION_TALENT_POOL` |
142
+| `SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLE_VIA_SAP_BUSINESS_ACCELERATOR_HUB` | `SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLE` |
143
+| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_CALIBRATION_SESSION_SERVICE` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CALIB_SESSION_SERVICE` |
144
+| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_CLOCK_INCLOCK_OUT_INTEGRATION_SERVICE` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CLOCK_INCLOCK_OUT` |
145
+| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_ONBOARDING_ADDITIONAL_SERVICES` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_ONBOARDING_ADDL` |
146
+| `SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_OR_FEEDBACK_REQUEST_RECORDS` | `SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_FEEDBACK` |
147
+| `SAP_SUCCESSFACTORS_QUERY_A_CLOCK_IN_CLOCK_OUT_GROUP_BY_CODE_WITH_TIME_EVENT_TYPES` | `SAP_SUCCESSFACTORS_QUERY_CLOCK_CLOCK_OUT_GROUP_CODE_TIME` |
148
+| `SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_IN_CLOCK_OUT_GROUPS` | `SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_CLOCK_OUT` |
149
+| `SAP_SUCCESSFACTORS_REFRESH_METADATA_FOR_CONTINUOUS_FEEDBACK_SERVICE` | `SAP_SUCCESSFACTORS_REFRESH_METADATA_CONT_FEEDBACK_SERVICE` |
150
+| `SAP_SUCCESSFACTORS_UPDATE_THE_INTERNAL_USERNAME_OF_NEW_HIRES_AFTER_HIRING_PROCESS_IS_COMPLETED_FROM_ACTIVE_DIRECTORY` | `SAP_SUCCESSFACTORS_UPDATE_INTERNAL_USERNAME_NEW_HIRES_AFTER` |
151
+| `SENTRY_RETRIEVE_CUSTOM_INTEGRATION_ISSUE_LINKS_FOR_THE_GIVEN_SENTRY_ISSUE` | `SENTRY_RETRIEVE_CUSTOM_INTEG_ISSUE_LINKS_GIVEN_SENTRY_ISSUE` |
152
+| `SENTRY_RETRIEVE_THE_CUSTOM_INTEGRATIONS_CREATED_BY_AN_ORGANIZATION` | `SENTRY_RETRIEVE_THE_CUSTOM_INTEGS_CREATED_BY_AN_ORG` |
153
+| `SHOPIFY_ADJUSTS_THE_INVENTORY_LEVEL_OF_AN_INVENTORY_ITEM_AT_A_LOCATION` | `SHOPIFY_ADJUSTS_INVENTORY_LEVEL_INVENTORY_ITEM_AT_LOCATION` |
154
+| `SHOPIFY_CREATE_PRICE_RULES_PARAM_PRICE_RULE_ID_DISCOUNT_CODES` | `SHOPIFY_CREATE_PRICE_RULES_PARAM_PRICE_RULE_ID_DISCOUNT` |
155
+| `SHOPIFY_DELETE_FULFILLMENT_SERVICES_PARAM_FULFILLMENT_SERVICE_ID` | `SHOPIFY_DELETE_FULFILLMENT_SERVICES_PARAM_FULFILLMENT` |
156
+| `SHOPIFY_GET_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM_PROVINCE_ID` | `SHOPIFY_GET_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM` |
157
+| `SHOPIFY_GET_FULFILLMENT_ORDERS_PARAM_FULFILLMENT_ORDER_ID_LOCATIONS_FOR_MOVE` | `SHOPIFY_GET_FULFILLMENT_ORDERS_PARAM_FULFILLMENT_ORDER_ID` |
158
+| `SHOPIFY_GET_PRICE_RULES_PARAM_PRICE_RULE_ID_BATCH_PARAM_BATCH_ID` | `SHOPIFY_GET_PRICE_RULES_PARAM_PRICE_RULE_ID_BATCH_PARAM` |
159
+| `SHOPIFY_PERFORMS_BULK_OPERATIONS_FOR_MULTIPLE_CUSTOMER_ADDRESSES` | `SHOPIFY_PERFORMS_BULK_OPERATIONS_MULTIPLE_CUSTOMER_ADDRESSES` |
160
+| `SHOPIFY_RETRIEVE_A_LIST_OF_METAFIELDS_FROM_THE_RESOURCE_S_ENDPOINT` | `SHOPIFY_RETRIEVE_LIST_METAFIELDS_RESOURCE_S_ENDPOINT` |
161
+| `SHOPIFY_RETRIEVE_A_LIST_OF_PRODUCTS_BELONGING_TO_A_COLLECTION` | `SHOPIFY_RETRIEVE_LIST_PRODUCTS_BELONGING_COLLECTION` |
162
+| `SHOPIFY_RETRIEVES_A_LIST_OF_ALL_ARTICLE_TAGS_FROM_A_SPECIFIC_BLOG` | `SHOPIFY_RETRIEVES_LIST_ALL_ARTICLE_TAGS_SPECIFIC_BLOG` |
163
+| `SHOPIFY_RETRIEVES_A_LIST_OF_DISCOUNT_CODES_FOR_A_DISCOUNT_CODE_CREATION_JOB` | `SHOPIFY_RETRIEVES_LIST_DISCOUNT_CODES_DISCOUNT_CODE` |
164
+| `SHOPIFY_RETRIEVES_A_LIST_OF_STOREFRONT_ACCESS_TOKENS_THAT_HAVE_BEEN_ISSUED` | `SHOPIFY_RETRIEVES_LIST_STOREFRONT_ACCESS_TOKENS_THAT_HAVE` |
165
+| `SHOPIFY_RETRIEVES_FULFILLMENTS_ASSOCIATED_WITH_A_FULFILLMENT_ORDER` | `SHOPIFY_RETRIEVES_FULFILLMENTS_ASSOCIATED_FULFILLMENT_ORDER` |
166
+| `SHOPIFY_SETS_THE_INVENTORY_LEVEL_FOR_AN_INVENTORY_ITEM_AT_A_LOCATION` | `SHOPIFY_SETS_INVENTORY_LEVEL_INVENTORY_ITEM_AT_LOCATION` |
167
+| `SHOPIFY_SHOP_RETRIEVE_A_LIST_OF_METAFIELDS_FROM_THE_RESOURCE_S_ENDPOINT` | `SHOPIFY_SHOP_RETRIEVE_LIST_METAFIELDS_RESOURCE_S_ENDPOINT` |
168
+| `SHOPIFY_UPDATE_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM_PROVINCE_ID` | `SHOPIFY_UPDATE_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM` |
169
+| `STRIPE_DELETE_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_DELETE_CUSTOMER_SUB_EXPOSED_ID` |
170
+| `STRIPE_DELETE_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID_DISCOUNT` | `STRIPE_DELETE_CUSTOMER_SUB_EXPOSED_ID_DISCOUNT` |
171
+| `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS_TRANSACTION` | `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TXNS_TXN` |
172
+| `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` |
173
+| `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID_DISCOUNT` | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID_DISCOUNT` |
174
+| `STRIPE_GET_V1_ACCOUNTS_CAPABILITIES_CAPABILITIES_ACCOUNTS_CAPABILITIES` | `STRIPE_GET_V1_ACCOUNTS_CAPABILITIES_CAPABILITIES_ACCOUNTS` |
175
+| `STRIPE_GET_V1_BILLING_CREDIT_BALANCE_TRANSACTIONS_OVERVIEW_BILLING_CREDIT_BALANCE_TRANSACTIONS` | `STRIPE_GET_V1_BILLING_CREDIT_BALANCE_TXNS_OVERVIEW_BILLING` |
176
+| `STRIPE_GET_V1_BILLING_PORTAL_CONFIGURATIONS_OVERVIEW_BILLING_PORTAL_CONFIGURATIONS` | `STRIPE_GET_V1_BILLING_PORTAL_CONFIGS_OVERVIEW_BILLING` |
177
+| `STRIPE_GET_V1_ENTITLEMENTS_ACTIVE_ENTITLEMENTS_ACTIVE_ENTITLEMENT` | `STRIPE_GET_V1_ENTITLEMENTS_ACTIVE_ENTITLEMENTS_ACTIVE` |
178
+| `STRIPE_GET_V1_FINANCIAL_CONNECTIONS_ACCOUNTS_OVERVIEW_FINANCIAL_CONNECTIONS_ACCOUNTS` | `STRIPE_GET_V1_FIN_CONNS_ACCOUNTS_OVERVIEW_FIN_CONNS_ACCOUNTS` |
179
+| `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD` | `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD` |
180
+| `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD2` | `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD2` |
181
+| `STRIPE_GET_V1_QUOTES_COMPUTED_UPFRONT_LINE_ITEMS_LIST_ALL_QUOTES` | `STRIPE_GET_V1_QUOTES_COMPUTED_UPFRONT_LINE_ITEMS_LIST_ALL` |
182
+| `STRIPE_GET_V1_REPORTING_REPORT_TYPES_OVERVIEW_REPORTING_REPORT_TYPES` | `STRIPE_GET_V1_REPORTING_REPORT_TYPES_OVERVIEW_REPORTING` |
183
+| `STRIPE_GET_V1_TEST_HELPERS_TEST_CLOCKS_DELETE_A_TEST_TEST_HELPERS_TEST_CLOCKS` | `STRIPE_GET_V1_TEST_HELPERS_TEST_CLOCKS_DELETE_TEST_TEST` |
184
+| `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` |
185
+| `STRIPE_POST_PAYMENT_RECORDS_ID_REPORT_PAYMENT_ATTEMPT_CANCELED` | `STRIPE_POST_PAYMENT_RECORDS_REPORT_ATTEMPT_CANCELED` |
186
+| `STRIPE_POST_PAYMENT_RECORDS_ID_REPORT_PAYMENT_ATTEMPT_INFORMATIONAL` | `STRIPE_POST_PAYMENT_RECORDS_REPORT_ATTEMPT_INFO` |
187
+| `STRIPE_POST_TAX_TRANSACTIONS_CREATE_FROM_CALCULATION_OVERVIEW` | `STRIPE_POST_TAX_TXNS_CREATE_FROM_CALCULATION_OVERVIEW` |
188
+| `STRIPE_POST_TERMINAL_READERS_CANCEL_ACTION_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_CANCEL_ACTION_SET_READER` |
189
+| `STRIPE_POST_TERMINAL_READERS_COLLECT_INPUTS_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_COLLECT_INPUTS_SET_READER` |
190
+| `STRIPE_POST_TERMINAL_READERS_CONFIRM_PAYMENT_INTENT_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_CONFIRM_PAYMENT_INTENT_SET` |
191
+| `STRIPE_POST_TEST_HELPERS_CUSTOMERS_FUND_CASH_BALANCE_FUND_A_TEST` | `STRIPE_POST_TEST_HELPERS_CUSTOMERS_FUND_CASH_BALANCE_FUND` |
192
+| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_PRESENT_PAYMENT_METHOD` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_PRESENT` |
193
+| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_SUCCEED_INPUT_COLLECTION` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_SUCCEED` |
194
+| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_TIMEOUT_INPUT_COLLECTION` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_TIMEOUT` |
195
+| `STRIPE_POST_V1_BILLING_PORTAL_CONFIGURATIONS_OVERVIEW_BILLING_PORTAL_CONFIGURATIONS` | `STRIPE_POST_V1_BILLING_PORTAL_CONFIGS_OVERVIEW_BILLING` |
196
+| `STRIPE_POST_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD2` | `STRIPE_POST_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD2` |
197
+| `STRIPE_POST_V1_PAYMENT_METHOD_DOMAINS_PAYMENT_METHOD_DOMAINS2` | `STRIPE_POST_V1_PAYMENT_METHOD_DOMAINS_PAYMENT_METHOD` |
198
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_CANCELED_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_CANCELED` |
199
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_GUARANTEED_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_GUARANTEED` |
200
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_INFORMATIONAL_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_INFO` |
201
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_ATTEMPT` |
202
+| `STRIPE_POST_V1_TEST_HELPERS_CONFIRMATION_TOKENS_CREATE_A_TEST` | `STRIPE_POST_V1_TEST_HELPERS_CONFIRMATION_TOKENS_CREATE_TEST` |
203
+| `STRIPE_POST_V2_BILLING_METER_EVENT_ADJUSTMENTS_METER_EVENT_ADJUSTMENTS` | `STRIPE_POST_V2_BILLING_METER_EVENT_ADJUSTMENTS_METER_EVENT` |
204
105
-</Accordion>
106
-</Accordions>
205
+</details>
206
207
## Migration
208
docs/content/changelog/01-12-26-tool-router-improvements.mdx
+5
-13
@@ -3,6 +3,8 @@ title: "Tool Router Improvements and New Features"
3
date: "2026-01-12"
4
---
5
6
+# Tool Router Improvements and New Features
7
+
8
## Version Information
9
10
### TypeScript/JavaScript
@@ -10,7 +12,7 @@ date: "2026-01-12"
12
- Version: `0.3.4` to `0.4.0`
13
14
### Python
13
-- Package: `composio-core` and provider packages
15
+- Package: `composio-core` and provider packages
16
- Version: `0.10.4` to `0.10.5`
17
18
## New Features
@@ -21,10 +23,6 @@ Added `waitForConnections` (TypeScript) / `wait_for_connections` (Python) proper
23
24
**TypeScript:**
25
```typescript
24
-import { Composio } from '@composio/core';
25
-const composio = new Composio({ apiKey: 'your-api-key' });
26
-const userId = 'user_123';
27
-// ---cut---
26
const session = await composio.toolRouter.create(userId, {
27
manageConnections: {
28
enable: true,
@@ -52,10 +50,6 @@ Introduced new modifier types for better session-based tool execution: `SessionE
50
51
**TypeScript:**
52
```typescript
55
-import { Composio } from '@composio/core';
56
-const composio = new Composio({ apiKey: 'your-api-key' });
57
-const session = await composio.toolRouter.create('user_123', { manageConnections: { enable: true } });
58
-// ---cut---
53
const tools = await session.tools({
54
modifySchema: ({ toolSlug, toolkitSlug, schema }) => schema,
55
beforeExecute: ({ toolSlug, toolkitSlug, sessionId, params }) => params,
@@ -71,7 +65,7 @@ from composio.core.models import before_execute_meta, after_execute_meta
65
def before_modifier(tool, toolkit, session_id, params):
66
return params
67
74
-@after_execute_meta
68
+@after_execute_meta
69
def after_modifier(tool, toolkit, session_id, response):
70
return response
71
@@ -84,9 +78,6 @@ Added `getRawToolRouterMetaTools` (TypeScript) / `get_raw_tool_router_meta_tools
78
79
**TypeScript:**
80
```typescript
87
-import { Composio } from '@composio/core';
88
-const composio = new Composio({ apiKey: 'your-api-key' });
89
-// ---cut---
81
const metaTools = await composio.tools.getRawToolRouterMetaTools('session_123', {
82
modifySchema: ({ toolSlug, toolkitSlug, schema }) => {
83
// Customize schema
@@ -138,3 +129,4 @@ This release is fully backward compatible:
129
| Optimized tool execution | No | No | No |
130
131
All changes follow semantic versioning principles and maintain full backward compatibility.
132
+
docs/content/changelog/01-14-26-auth-config-patch-semantics.mdx
+57
-55
@@ -3,6 +3,8 @@ title: "True PATCH Semantics for Auth Config Updates"
3
date: "2026-01-14"
4
---
5
6
+# True PATCH Semantics for Auth Config Updates
7
+
8
## Version Information
9
10
### TypeScript/JavaScript
@@ -17,9 +19,9 @@ date: "2026-01-14"
19
20
The `PATCH /api/v3/auth_configs/{id}` endpoint now implements proper partial update semantics. Previously, omitting fields would clear them (behaving like PUT). Now, omitted fields are preserved—only explicitly provided fields are modified.
21
20
-<Callout type="warn">
22
+<Warning>
23
**Breaking Change**: If you relied on omitting fields to clear them, you must now explicitly send `null` or `[]`. See [Migration Guide](#migration-guide) below.
22
-</Callout>
24
+</Warning>
25
26
## What Changed
27
@@ -30,9 +32,9 @@ The `PATCH /api/v3/auth_configs/{id}` endpoint now implements proper partial upd
32
| `scopes` (type: default) | Cleared if omitted | Preserved if omitted |
33
| `restrict_to_following_tools` | Reset to `[]` if omitted | Preserved if omitted |
34
33
-<Callout type="info">
35
+<Note>
36
**Merge Behavior**: The `credentials` object is merged—send only the fields you want to change, and existing fields are preserved.
35
-</Callout>
37
+</Note>
38
39
## New Capabilities
40
@@ -40,27 +42,27 @@ The `PATCH /api/v3/auth_configs/{id}` endpoint now implements proper partial upd
42
43
Update just `client_secret` without resending `client_id` or other fields:
44
43
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
44
-<Tab value="Python">
45
-```python
45
+<CodeBlocks>
46
+```python title="Python SDK"
47
from composio import Composio
48
49
composio = Composio()
50
51
# Only send the field you want to update - other credentials are preserved
52
+
53
composio.auth_configs.update(
52
- "ac_yourAuthConfigId",
53
- options={
54
- "type": "custom",
55
- "credentials": {
56
- "client_secret": "new_rotated_secret",
57
- },
58
- },
54
+"ac_yourAuthConfigId",
55
+options={
56
+"type": "custom",
57
+"credentials": {
58
+"client_secret": "new_rotated_secret",
59
+},
60
+},
61
)
60
-```
61
-</Tab>
62
-<Tab value="TypeScript">
63
-```typescript
62
+
63
+````
64
+
65
+```typescript title="TypeScript SDK"
66
import { Composio } from "@composio/core";
67
68
const composio = new Composio();
@@ -72,35 +74,35 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
74
client_secret: "new_rotated_secret",
75
},
76
});
75
-```
76
-</Tab>
77
-</Tabs>
77
+````
78
+
79
+</CodeBlocks>
80
81
### Update Tool Restrictions Without Touching Credentials
82
83
Previously, this would fail because `credentials` was required. Now it works:
84
83
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
84
-<Tab value="Python">
85
-```python
85
+<CodeBlocks>
86
+```python title="Python SDK"
87
from composio import Composio
88
89
composio = Composio()
90
91
# Update tool restrictions - credentials are automatically preserved
92
+
93
composio.auth_configs.update(
92
- "ac_yourAuthConfigId",
93
- options={
94
- "type": "custom",
95
- "tool_access_config": {
96
- "tools_available_for_execution": ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],
97
- },
98
- },
94
+"ac_yourAuthConfigId",
95
+options={
96
+"type": "custom",
97
+"tool_access_config": {
98
+"tools_available_for_execution": ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],
99
+},
100
+},
101
)
100
-```
101
-</Tab>
102
-<Tab value="TypeScript">
103
-```typescript
102
+
103
+````
104
+
105
+```typescript title="TypeScript SDK"
106
import { Composio } from "@composio/core";
107
108
const composio = new Composio();
@@ -115,9 +117,9 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
117
toolsAvailableForExecution: ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],
118
},
119
});
118
-```
119
-</Tab>
120
-</Tabs>
120
+````
121
+
122
+</CodeBlocks>
123
124
## Migration Guide
125
@@ -134,27 +136,27 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
136
| `tool_access_config` | `"tool_access_config": {"tools_available_for_execution": []}` | `toolAccessConfig: { toolsAvailableForExecution: [] }` |
137
| `scopes` (default) | `"scopes": ""` | `scopes: ""` (via HTTP API) |
138
137
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
138
-<Tab value="Python">
139
-```python
139
+<CodeBlocks>
140
+```python title="Python SDK - Clear tool restrictions"
141
from composio import Composio
142
143
composio = Composio()
144
145
# Explicitly clear tool restrictions with empty array
146
+
147
composio.auth_configs.update(
146
- "ac_yourAuthConfigId",
147
- options={
148
- "type": "custom",
149
- "tool_access_config": {
150
- "tools_available_for_execution": [],
151
- },
152
- },
148
+"ac_yourAuthConfigId",
149
+options={
150
+"type": "custom",
151
+"tool_access_config": {
152
+"tools_available_for_execution": [],
153
+},
154
+},
155
)
154
-```
155
-</Tab>
156
-<Tab value="TypeScript">
157
-```typescript
156
+
157
+````
158
+
159
+```typescript title="TypeScript SDK - Clear tool restrictions"
160
import { Composio } from "@composio/core";
161
162
const composio = new Composio();
@@ -169,9 +171,9 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
171
toolsAvailableForExecution: [],
172
},
173
});
172
-```
173
-</Tab>
174
-</Tabs>
174
+````
175
+
176
+</CodeBlocks>
177
178
### Raw HTTP API
179
docs/content/changelog/01-20-26-file-modifier-anyof-support.mdx
+27
-35
@@ -1,8 +1,10 @@
1
---
2
-title: "[Critical] File Upload/Download Fixes for anyOf, oneOf, and allOf Schemas"
2
+title: "File Upload/Download Fixes for latest tool with anyOf, oneOf, and allOf Schemas"
3
date: "2026-01-20"
4
---
5
6
+# [Critical] File Upload/Download Fixes for `latest` tool with anyOf, oneOf, and allOf Schemas
7
+
8
## Version Information
9
10
### TypeScript/JavaScript
@@ -17,9 +19,9 @@ date: "2026-01-20"
19
20
The file handling modifiers now properly handle `file_uploadable` and `file_downloadable` properties nested within `anyOf`, `oneOf`, and `allOf` JSON Schema declarations. Previously, only direct child properties (and partial `allOf` support) were detected for file upload/download transformations.
21
20
-<Callout type="info">
22
+<Note>
23
We recommend updating to version `0.5.3` (TypeScript) or `0.10.8` (Python) or later to ensure file uploads and downloads work correctly with tools that use union or intersection types in their schemas.
22
-</Callout>
24
+</Note>
25
26
## What Changed
27
@@ -28,7 +30,6 @@ We recommend updating to version `0.5.3` (TypeScript) or `0.10.8` (Python) or la
30
File properties inside `anyOf`, `oneOf`, or `allOf` were not detected:
31
32
```typescript
31
-// @noErrors
33
// This schema's file_uploadable was NOT being processed
34
inputParameters: {
35
type: 'object',
@@ -53,7 +54,6 @@ inputParameters: {
54
File properties are now correctly detected and processed at any nesting level:
55
56
```typescript
56
-// @noErrors
57
// Now properly detected and transformed
58
inputParameters: {
59
type: 'object',
@@ -77,56 +77,48 @@ inputParameters: {
77
78
| Scenario | Before | After |
79
|----------|--------|-------|
80
-| `file_uploadable` in `anyOf` | Not detected | Works |
81
-| `file_uploadable` in `oneOf` | Not detected | Works |
82
-| `file_uploadable` in `allOf` | Not detected | Works |
83
-| `file_downloadable` in `anyOf` | Not detected | Works |
84
-| `file_downloadable` in `oneOf` | Not detected | Works |
85
-| `file_downloadable` in `allOf` | Not detected | Works |
86
-| Nested objects inside union types | Not detected | Works |
87
-| Array items with union types | Not detected | Works |
80
+| `file_uploadable` in `anyOf` | Not detected | ✅ Works |
81
+| `file_uploadable` in `oneOf` | Not detected | ✅ Works |
82
+| `file_uploadable` in `allOf` | Not detected | ✅ Works |
83
+| `file_downloadable` in `anyOf` | Not detected | ✅ Works |
84
+| `file_downloadable` in `oneOf` | Not detected | ✅ Works |
85
+| `file_downloadable` in `allOf` | Not detected | ✅ Works |
86
+| Nested objects inside union types | Not detected | ✅ Works |
87
+| Array items with union types | Not detected | ✅ Works |
88
89
## How to Update
90
91
### TypeScript/JavaScript
92
93
-<Tabs groupId="package-manager" items={['npm', 'pnpm', 'yarn']} persist>
94
-<Tab value="npm">
95
-```bash
93
+<CodeBlocks>
94
+```bash title="npm"
95
npm update @composio/core@latest
96
```
98
-</Tab>
99
-<Tab value="pnpm">
100
-```bash
97
+
98
+```bash title="pnpm"
99
pnpm update @composio/core@latest
100
```
103
-</Tab>
104
-<Tab value="yarn">
105
-```bash
101
+
102
+```bash title="yarn"
103
yarn upgrade @composio/core@latest
104
```
108
-</Tab>
109
-</Tabs>
105
+</CodeBlocks>
106
107
### Python
108
113
-<Tabs groupId="python-package-manager" items={['pip', 'uv', 'poetry']} persist>
114
-<Tab value="pip">
115
-```bash
109
+<CodeBlocks>
110
+```bash title="pip"
111
pip install --upgrade composio
112
```
118
-</Tab>
119
-<Tab value="uv">
120
-```bash
113
+
114
+```bash title="uv"
115
uv pip install --upgrade composio
116
```
123
-</Tab>
124
-<Tab value="poetry">
125
-```bash
117
+
118
+```bash title="poetry"
119
poetry update composio
120
```
128
-</Tab>
129
-</Tabs>
121
+</CodeBlocks>
122
123
## Backward Compatibility
124
docs/content/changelog/01-20-26-file-ttl.mdx
+2
@@ -3,6 +3,8 @@ title: "File handling in tool execution now uses presigned URLs"
3
date: "2026-01-20"
4
---
5
6
+# File handling in tool execution now uses presigned URLs
7
+
8
## Summary
9
10
Files involved in tool execution are now shared via presigned URLs with a default TTL (time-to-live) of 1 hour. You can customize the file TTL through your project configuration.
docs/content/changelog/01-21-26-initiate-active-status-filter.mdx
new
+49
@@ -0,0 +1,49 @@
1
+---
2
+title: "Connected Account Initiate Now Filters by ACTIVE Status"
3
+date: "2026-01-21"
4
+---
5
+
6
+# Connected Account Initiate Now Filters by ACTIVE Status
7
+
8
+## Version Information
9
+
10
+### TypeScript/JavaScript
11
+- Package: `@composio/core`
12
+- Version: `0.5.4`+
13
+
14
+### Python
15
+- Package: `composio`
16
+- Version: `0.10.9`+
17
+
18
+---
19
+
20
+The `initiate()` method now only considers ACTIVE connected accounts when checking for duplicates. Previously, expired or inactive accounts would incorrectly trigger the multiple accounts error.
21
+
22
+## What Changed
23
+
24
+When calling `connectedAccounts.initiate()`, the SDK now filters by `statuses: ["ACTIVE"]` when checking for existing accounts. This prevents expired or inactive accounts from blocking new connection creation.
25
+
26
+### Before (Bug)
27
+
28
+```typescript
29
+// Expired accounts would incorrectly trigger ComposioMultipleConnectedAccountsError
30
+await composio.connectedAccounts.initiate(userId, authConfigId);
31
+// ❌ Error: Multiple connected accounts found (even if they're all expired)
32
+```
33
+
34
+### After (Fixed)
35
+
36
+```typescript
37
+// Only ACTIVE accounts are considered
38
+await composio.connectedAccounts.initiate(userId, authConfigId);
39
+// ✅ Works - expired/inactive accounts are ignored
40
+```
41
+
42
+## Affected SDKs
43
+
44
+- **TypeScript**: `@composio/core`
45
+- **Python**: `composio`
46
+
47
+## Backward Compatibility
48
+
49
+This is a bug fix with no breaking changes. The behavior now matches the expected intent of the multiple accounts check.
docs/content/changelog/01-22-26-experimental-assistive-prompts.mdx
new
+118
@@ -0,0 +1,118 @@
1
+---
2
+title: "Experimental Assistive Prompts and API Updates"
3
+date: "2026-01-22"
4
+---
5
+
6
+# Experimental Assistive Prompts and API Updates
7
+
8
+## Version Information
9
+
10
+### TypeScript/JavaScript
11
+- Package: `@composio/core`
12
+- Version: `0.5.5`+
13
+
14
+### Python
15
+- Package: `composio`
16
+- Version: `0.10.10`+
17
+
18
+## New Features
19
+
20
+### Experimental Assistive Prompt Configuration
21
+
22
+Tool Router sessions now support experimental configuration for timezone-aware assistive prompts. When you provide a user's timezone, the session returns a contextual assistive prompt that includes timezone-specific guidance.
23
+
24
+<Warning>
25
+This is an experimental feature. The API may change or be removed in future versions.
26
+</Warning>
27
+
28
+<CodeBlocks>
29
+```python title="Python SDK"
30
+from composio import Composio
31
+
32
+composio = Composio()
33
+
34
+session = composio.tool_router.create(
35
+ user_id="user_123",
36
+ toolkits=["github"],
37
+ experimental={
38
+ "assistive_prompt": {
39
+ "user_timezone": "America/New_York",
40
+ }
41
+ },
42
+)
43
+
44
+# Access the generated assistive prompt
45
+if session.experimental:
46
+ print(session.experimental.assistive_prompt)
47
+```
48
+
49
+```typescript title="TypeScript SDK"
50
+import { Composio } from "@composio/core";
51
+
52
+const composio = new Composio();
53
+
54
+const session = await composio.toolRouter.create("user_123", {
55
+ toolkits: ["github"],
56
+ experimental: {
57
+ assistivePrompt: {
58
+ userTimezone: "America/New_York",
59
+ },
60
+ },
61
+});
62
+
63
+// Access the generated assistive prompt
64
+if (session.experimental) {
65
+ console.log(session.experimental.assistivePrompt);
66
+}
67
+```
68
+</CodeBlocks>
69
+
70
+<Note>
71
+The `experimental` field is only available on sessions created with `create()`. Sessions retrieved with `use()` do not include the experimental data.
72
+</Note>
73
+
74
+### Toolkit Endpoint Method
75
+
76
+The toolkit retrieve response now includes `getCurrentUserEndpointMethod` (TypeScript) / `get_current_user_endpoint_method` (Python) to indicate the HTTP method for the current user endpoint.
77
+
78
+## Breaking Changes
79
+
80
+### Trigger Pagination: `page` Replaced with `cursor`
81
+
82
+The `page` parameter in `listActive` / `list_active` for trigger instances has been replaced with `cursor` for cursor-based pagination. There was a bug in earlier APIs which caused `page` param to be ignored, going ahead for pagination please use `cursor` instead.
83
+
84
+<CodeBlocks>
85
+```python title="Python SDK"
86
+# Before (deprecated)
87
+triggers = composio.triggers.list_active(page=1, limit=10)
88
+
89
+# After
90
+triggers = composio.triggers.list_active(cursor="cursor_string", limit=10)
91
+# Use response.next_cursor for the next page
92
+```
93
+
94
+```typescript title="TypeScript SDK"
95
+// Before (deprecated)
96
+const triggers = await composio.triggers.listActive({ page: 1, limit: 10 });
97
+
98
+// After
99
+const triggers = await composio.triggers.listActive({ cursor: "cursor_string", limit: 10 });
100
+// Use response.nextCursor for the next page
101
+```
102
+</CodeBlocks>
103
+
104
+## Impact Summary
105
+
106
+| Change | Runtime Breaking | TypeScript Breaking | Migration Required |
107
+|--------|------------------|---------------------|-------------------|
108
+| Experimental assistive prompts | No | No | No |
109
+| `getCurrentUserEndpointMethod` field | No | No | No |
110
+| `page` → `cursor` in triggers | Yes | Yes | Yes (if using `page`) |
111
+
112
+## Migration Guide
113
+
114
+If you are using the `page` parameter in `listActive` / `list_active`:
115
+
116
+1. Replace `page` with `cursor`
117
+2. For the first request, omit the `cursor` parameter or pass `undefined`/`None`
118
+3. Use the `nextCursor` / `next_cursor` from the response for subsequent requests