@devries-cameron20 / composio Mirror · read-only / commits / 2ebec7621
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 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