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: sync January changelog files from fern

Sushmithamallesh2ebec7621709
diff --git a/docs/content/changelog/01-07-26.mdx b/docs/content/changelog/01-07-26.mdx
index 1a19ad46c..cf01f9b93 100644
--- a/docs/content/changelog/01-07-26.mdx
+++ b/docs/content/changelog/01-07-26.mdx
@@ -1,20 +1,20 @@
---
-title: "Consistent Error Response Structure & Union Types Preserved"
+title: "Consistent Error Response Structure"
date: "2026-01-07"
---
-## Consistent Error Response Structure
+# Consistent Error Response Structure
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.
-### What Changed
+## What Changed
All error responses from tool execution now include:
- `data.status_code`: HTTP status code (or `null` for non-HTTP errors)
- `data.message`: Detailed error message
- `error`: Same detailed message at the top level
-### Before vs After
+## Before vs After
**Previous error response:**
```json
@@ -38,7 +38,7 @@ All error responses from tool execution now include:
}
```
-### Why This Matters
+## Why This Matters
- **Easier parsing**: Agents and code can reliably access error details from `data.message` without special-casing empty `data` objects
- **Better debugging**: Detailed error messages replace generic HTTP error strings
@@ -46,11 +46,11 @@ All error responses from tool execution now include:
---
-## Union Types Preserved in Tool Schemas
+# Union Types Preserved in Tool Schemas
Tool schemas now use standard JSON Schema `anyOf` for union types, providing accurate type information for LLMs and code generators.
-### What Changed
+## What Changed
Two changes affect how types appear in request/response schemas:
@@ -59,7 +59,6 @@ Two changes affect how types appear in request/response schemas:
| **Nullable fields** | **All toolkits** | Fields that accept `null` now use `anyOf: [{type}, {type: "null"}]` instead of `type` + `nullable: true` |
| **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 |
-<Accordions>
<Accordion title="Toolkits with multi-type union fields (157 total)">
### CRM & Sales
@@ -111,11 +110,9 @@ clearout, icypeas, neverbounce, zerobounce
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
</Accordion>
-</Accordions>
-### Before vs After
+## Before vs After
For example, the `GOOGLECALENDAR_GET_CURRENT_DATE_TIME` request schema changes:
-
**Previous (only a single type):**
```json
{
@@ -173,7 +170,7 @@ Similarly, nullable fields like `page_token` in `GOOGLECALENDAR_LIST_CALENDARS`:
}
```
-### Why This Matters
+## Why This Matters
- **Accurate schemas**: LLMs and code generators see the full set of allowed types
-- **Better validation**: Input validation can now correctly accept all valid types, not just the first one
+- **Better validation**: Input validation can now correctly accept all valid types, not just the first one
\ No newline at end of file
diff --git a/docs/content/changelog/01-08-26-mcp-api-key-enforcement.mdx b/docs/content/changelog/01-08-26-mcp-api-key-enforcement.mdx
index 43d85437f..c9632096b 100644
--- a/docs/content/changelog/01-08-26-mcp-api-key-enforcement.mdx
+++ b/docs/content/changelog/01-08-26-mcp-api-key-enforcement.mdx
@@ -3,11 +3,13 @@ title: "Optional API Key Enforcement for MCP Servers"
date: "2026-01-08"
---
+# Optional API Key Enforcement for MCP Servers
+
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.
-<Callout type="info">
+<Note>
**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.
-</Callout>
+</Note>
## What's New
@@ -58,6 +60,10 @@ curl -X POST "https://mcp.composio.dev/{your_mcp_server_url}" \
3. Find the **"Require API Key for MCP"** toggle
4. Enable the toggle
+<Frame>
+ <img src="/assets/images/mcp-api-key-toggle.png" alt="MCP API Key Toggle in Project Settings" />
+</Frame>
+
### Via API
Update your project configuration using the API:
@@ -81,6 +87,7 @@ curl -X PATCH "https://backend.composio.dev/api/v3/org/project/config" \
### Via Code
+<CodeGroup>
```python title="Python"
import requests
@@ -95,7 +102,6 @@ response = requests.patch(
print(response.json())
```
-
```typescript title="TypeScript"
const response = await fetch(
"https://backend.composio.dev/api/v3/org/project/config",
@@ -111,6 +117,7 @@ const response = await fetch(
console.log(await response.json());
```
+</CodeGroup>
## When to Use This
diff --git a/docs/content/changelog/01-09-26.mdx b/docs/content/changelog/01-09-26.mdx
index f91e21f7b..97ca8ab44 100644
--- a/docs/content/changelog/01-09-26.mdx
+++ b/docs/content/changelog/01-09-26.mdx
@@ -3,6 +3,8 @@ title: "Tool Enum Name Shortening"
date: "2026-01-09"
---
+# Tool Enum Name Shortening
+
Shortened tool enum names across 181 actions to ensure compatibility with all AI agent frameworks.
## Why This Change?
@@ -13,8 +15,8 @@ Some agent frameworks have a **64-character limit** on tool/function names. Seve
**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.
-<Accordions>
-<Accordion title="View All Enum Changes (181 tools)">
+<details>
+<summary><strong>View All Enum Changes (181 tools)</strong></summary>
| Old Enum | New Enum |
|----------|----------|
@@ -100,10 +102,107 @@ Some agent frameworks have a **64-character limit** on tool/function names. Seve
| `DEPLOYHQ_DELETE_PROJECTS_PROJECT_BUILD_CACHE_FILES_IDENTIFIER` | `DEPLOYHQ_DELETE_PROJECTS_PROJECT_BUILD_CACHE_FILES` |
| `DROPBOX_SIGN_EDIT_AND_RESEND_EMBEDDED_SIGNATURE_REQUEST_WITH_TEMPLATE` | `DROPBOX_SIGN_EDIT_RESEND_EMBEDDED_SIGNATURE_REQUEST_TEMPLATE` |
| `GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATION` | `GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORG` |
-| ... and 100+ more |
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_BIG_QUERY_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_BIG_QUERY_LINKS` |
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CHANNELGROUPS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CHANNELGROUPS` |
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CONVERSIONEVENTS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CONVERSIONEVENTS` |
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CUSTOMDIMENSIONS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_CUSTOMDIMENSIONS` |
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_DATASTREAMS_MEASUREMENTPROTOCOLSECRETS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_DATASTREAMS` |
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_DISPLAY_VIDEO360_ADVERTISER_LINK_PROPOSALS_LIST` | `GOOGLE_ANALYTICS_ADMIN_PROPS_DV360_LINK_PROPOSALS_LIST` |
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_DISPLAY_VIDEO360_ADVERTISER_LINKS_LIST` | `GOOGLE_ANALYTICS_ADMIN_PROPS_DV360_AD_LINKS_LIST` |
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_EXPANDEDDATASETS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_EXPANDEDDATASETS` |
+| `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_FIREBASELINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICSADMIN_PROPERTIES_FIREBASELINKS` |
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_GOOGLE_ADS` |
+| `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_SEARCH_ADS360_LINKS_LIST` | `GOOGLE_ANALYTICS_ANALYTICS_ADMIN_PROPERTIES_SEARCH_ADS360` |
+| `GOOGLE_ANALYTICS_PROPERTIES_DATASTREAMS_EVENTCREATERULES_LIST_ACTION` | `GOOGLE_ANALYTICS_PROPERTIES_DATASTREAMS_EVENTCREATERULES` |
+| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_DELETE` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_DELETE` |
+| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_GET` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_GET` |
+| `GOOGLE_CLASSROOM_COURSES_ANNOUNCEMENTS_ADD_ON_ATTACHMENTS_LIST` | `GOOGLE_CLASSROOM_COURSES_ANNOUNCES_ADD_ON_ATTACHS_LIST` |
+| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_ADD_ON_ATTACHMENTS_DELETE` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_ADD_ON_ATTACHS_DELETE` |
+| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_ADD_ON_ATTACHMENTS_LIST` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_ADD_ATTACHS` |
+| `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_GET_ADD_ON_CONTEXT` | `GOOGLE_CLASSROOM_COURSES_COURSE_WORK_MATERIALS_GET_ADD` |
+| `INSTANTLY_DFY_EMAIL_ACCOUNT_ORDERS_DOMAINS_PRE_WARMED_UP_LIST_POST` | `INSTANTLY_DFY_EMAIL_ACCOUNT_ORDERS_DOMAINS_PRE_WARMED_UP` |
+| `INSTANTLY_LIST_INBOX_PLACEMENT_BLACKLIST_AND_SPAM_ASSASSIN_REPORTS` | `INSTANTLY_LIST_INBOX_PLACEMENT_BLACKLIST_SPAM_ASSASSIN` |
+| `METABASE_DELETE_API_USER_KEY_VALUE_NAMESPACE_NAMESPACE_KEY_KEY` | `METABASE_DELETE_API_USER_KEY_VALUE_NAMESPACE_NAMESPACE_KEY` |
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_DATABASE_ID_CANDIDATES` | `METABASE_GET_API_AUTO_DASHBOARDS_DATABASE_ID_CANDIDATES` |
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_CELL_CELL_QUERY` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_CELL_QUERY` |
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_CELL_CELL_QUERY_RULE_PREFIX` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_CELL_QUERY_RULE` |
+| `METABASE_GET_API_AUTOMAGIC_DASHBOARDS_ENTITY_ENTITY_ID_OR_QUERY_QUERY_METADATA` | `METABASE_GET_AUTOMAGIC_DASH_ENTITY_QUERY_METADATA` |
+| `METABASE_GET_API_DASHBOARD_ID_PARAMS_PARAM_KEY_REMAPPING` | `METABASE_GET_API_DASH_ID_PARAMS_PARAM_KEY_REMAPPING` |
+| `METABASE_GET_API_DASHBOARD_ID_PARAMS_PARAM_KEY_VALUES` | `METABASE_GET_API_DASH_ID_PARAMS_PARAM_KEY_VALUES` |
+| `METABASE_POST_API_DASHBOARD_SAVE_COLLECTION_PARENT_COLLECTION_ID` | `METABASE_POST_API_DASH_SAVE_COLLECTION_PARENT_COLLECTION_ID` |
+| `METABASE_POST_API_EE_METABOT_TOOLS_CREATE_DASHBOARD_SUBSCRIPTION` | `METABASE_POST_API_EE_METABOT_TOOLS_CREATE_DASH_SUB` |
+| `METABASE_POST_API_EE_METABOT_TOOLS_GET_DASHBOARD_DETAILS` | `METABASE_POST_API_EE_METABOT_TOOLS_GET_DASH_DETAILS` |
+| `METABASE_POST_API_EE_METABOT_TOOLS_GET_DOCUMENT_DETAILS` | `METABASE_POST_API_EE_METABOT_TOOLS_GET_DOC_DETAILS` |
+| `SALESFORCE_GET_VALUES_FOR_ALL_PICKLIST_FIELDS_OF_A_RECORD_TYPE` | `SALESFORCE_GET_PICKLIST_VALUES_BY_RECORD_TYPE` |
+| `SALESFORCE_GET_UIAPI_LIST_INFO_ACCOUNT_RECENT_LISTS_ONLY_TRUE` | `SALESFORCE_GET_UI_API_LIST_INFO_RECENT` |
+| `SALESFORCE_GET_UIAPI_RELATED_LIST_PREFERENCES_BATCH_ACCOUNTRELATEDCONTACTLISTACCOUNTRELATEDOPPORTUNITYLIST` | `SALESFORCE_GET_RELATED_LIST_PREFS_BATCH` |
+| `SALESFORCE_SERVICE_CLOUD_VISITOR_SENSITIVE_DATA_RULE_TRIGGERED` | `SALESFORCE_SERVICE_CLOUD_VISITOR_SENSITIVE_DATA_RULE` |
+| `SAP_SUCCESSFACTORS_CREATE_OR_UPDATE_A_SUCCESSOR_NOMINATION_FOR_A_POSITION_OR_TALENT_POOL` | `SAP_SUCCESSFACTORS_CREATE_UPDATE_SUCCESSOR_NOMINATION` |
+| `SAP_SUCCESSFACTORS_DELETE_A_NOMINATION_FOR_A_POSITION_OR_TALENT_POOL` | `SAP_SUCCESSFACTORS_DELETE_NOMINATION_POSITION_TALENT_POOL` |
+| `SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLE_VIA_SAP_BUSINESS_ACCELERATOR_HUB` | `SAP_SUCCESSFACTORS_GET_FEEDBACK_RECORDS_SERVICE_AVAILABLE` |
+| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_CALIBRATION_SESSION_SERVICE` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CALIB_SESSION_SERVICE` |
+| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_CLOCK_INCLOCK_OUT_INTEGRATION_SERVICE` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_CLOCK_INCLOCK_OUT` |
+| `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_FOR_ONBOARDING_ADDITIONAL_SERVICES` | `SAP_SUCCESSFACTORS_GET_ODATA_METADATA_ONBOARDING_ADDL` |
+| `SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_OR_FEEDBACK_REQUEST_RECORDS` | `SAP_SUCCESSFACTORS_GET_PENDING_FEEDBACK_REQUESTS_FEEDBACK` |
+| `SAP_SUCCESSFACTORS_QUERY_A_CLOCK_IN_CLOCK_OUT_GROUP_BY_CODE_WITH_TIME_EVENT_TYPES` | `SAP_SUCCESSFACTORS_QUERY_CLOCK_CLOCK_OUT_GROUP_CODE_TIME` |
+| `SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_IN_CLOCK_OUT_GROUPS` | `SAP_SUCCESSFACTORS_QUERY_ALL_AVAILABLE_CLOCK_CLOCK_OUT` |
+| `SAP_SUCCESSFACTORS_REFRESH_METADATA_FOR_CONTINUOUS_FEEDBACK_SERVICE` | `SAP_SUCCESSFACTORS_REFRESH_METADATA_CONT_FEEDBACK_SERVICE` |
+| `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` |
+| `SENTRY_RETRIEVE_CUSTOM_INTEGRATION_ISSUE_LINKS_FOR_THE_GIVEN_SENTRY_ISSUE` | `SENTRY_RETRIEVE_CUSTOM_INTEG_ISSUE_LINKS_GIVEN_SENTRY_ISSUE` |
+| `SENTRY_RETRIEVE_THE_CUSTOM_INTEGRATIONS_CREATED_BY_AN_ORGANIZATION` | `SENTRY_RETRIEVE_THE_CUSTOM_INTEGS_CREATED_BY_AN_ORG` |
+| `SHOPIFY_ADJUSTS_THE_INVENTORY_LEVEL_OF_AN_INVENTORY_ITEM_AT_A_LOCATION` | `SHOPIFY_ADJUSTS_INVENTORY_LEVEL_INVENTORY_ITEM_AT_LOCATION` |
+| `SHOPIFY_CREATE_PRICE_RULES_PARAM_PRICE_RULE_ID_DISCOUNT_CODES` | `SHOPIFY_CREATE_PRICE_RULES_PARAM_PRICE_RULE_ID_DISCOUNT` |
+| `SHOPIFY_DELETE_FULFILLMENT_SERVICES_PARAM_FULFILLMENT_SERVICE_ID` | `SHOPIFY_DELETE_FULFILLMENT_SERVICES_PARAM_FULFILLMENT` |
+| `SHOPIFY_GET_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM_PROVINCE_ID` | `SHOPIFY_GET_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM` |
+| `SHOPIFY_GET_FULFILLMENT_ORDERS_PARAM_FULFILLMENT_ORDER_ID_LOCATIONS_FOR_MOVE` | `SHOPIFY_GET_FULFILLMENT_ORDERS_PARAM_FULFILLMENT_ORDER_ID` |
+| `SHOPIFY_GET_PRICE_RULES_PARAM_PRICE_RULE_ID_BATCH_PARAM_BATCH_ID` | `SHOPIFY_GET_PRICE_RULES_PARAM_PRICE_RULE_ID_BATCH_PARAM` |
+| `SHOPIFY_PERFORMS_BULK_OPERATIONS_FOR_MULTIPLE_CUSTOMER_ADDRESSES` | `SHOPIFY_PERFORMS_BULK_OPERATIONS_MULTIPLE_CUSTOMER_ADDRESSES` |
+| `SHOPIFY_RETRIEVE_A_LIST_OF_METAFIELDS_FROM_THE_RESOURCE_S_ENDPOINT` | `SHOPIFY_RETRIEVE_LIST_METAFIELDS_RESOURCE_S_ENDPOINT` |
+| `SHOPIFY_RETRIEVE_A_LIST_OF_PRODUCTS_BELONGING_TO_A_COLLECTION` | `SHOPIFY_RETRIEVE_LIST_PRODUCTS_BELONGING_COLLECTION` |
+| `SHOPIFY_RETRIEVES_A_LIST_OF_ALL_ARTICLE_TAGS_FROM_A_SPECIFIC_BLOG` | `SHOPIFY_RETRIEVES_LIST_ALL_ARTICLE_TAGS_SPECIFIC_BLOG` |
+| `SHOPIFY_RETRIEVES_A_LIST_OF_DISCOUNT_CODES_FOR_A_DISCOUNT_CODE_CREATION_JOB` | `SHOPIFY_RETRIEVES_LIST_DISCOUNT_CODES_DISCOUNT_CODE` |
+| `SHOPIFY_RETRIEVES_A_LIST_OF_STOREFRONT_ACCESS_TOKENS_THAT_HAVE_BEEN_ISSUED` | `SHOPIFY_RETRIEVES_LIST_STOREFRONT_ACCESS_TOKENS_THAT_HAVE` |
+| `SHOPIFY_RETRIEVES_FULFILLMENTS_ASSOCIATED_WITH_A_FULFILLMENT_ORDER` | `SHOPIFY_RETRIEVES_FULFILLMENTS_ASSOCIATED_FULFILLMENT_ORDER` |
+| `SHOPIFY_SETS_THE_INVENTORY_LEVEL_FOR_AN_INVENTORY_ITEM_AT_A_LOCATION` | `SHOPIFY_SETS_INVENTORY_LEVEL_INVENTORY_ITEM_AT_LOCATION` |
+| `SHOPIFY_SHOP_RETRIEVE_A_LIST_OF_METAFIELDS_FROM_THE_RESOURCE_S_ENDPOINT` | `SHOPIFY_SHOP_RETRIEVE_LIST_METAFIELDS_RESOURCE_S_ENDPOINT` |
+| `SHOPIFY_UPDATE_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM_PROVINCE_ID` | `SHOPIFY_UPDATE_COUNTRIES_PARAM_COUNTRY_ID_PROVINCES_PARAM` |
+| `STRIPE_DELETE_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_DELETE_CUSTOMER_SUB_EXPOSED_ID` |
+| `STRIPE_DELETE_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID_DISCOUNT` | `STRIPE_DELETE_CUSTOMER_SUB_EXPOSED_ID_DISCOUNT` |
+| `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS_TRANSACTION` | `STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TXNS_TXN` |
+| `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` |
+| `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID_DISCOUNT` | `STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID_DISCOUNT` |
+| `STRIPE_GET_V1_ACCOUNTS_CAPABILITIES_CAPABILITIES_ACCOUNTS_CAPABILITIES` | `STRIPE_GET_V1_ACCOUNTS_CAPABILITIES_CAPABILITIES_ACCOUNTS` |
+| `STRIPE_GET_V1_BILLING_CREDIT_BALANCE_TRANSACTIONS_OVERVIEW_BILLING_CREDIT_BALANCE_TRANSACTIONS` | `STRIPE_GET_V1_BILLING_CREDIT_BALANCE_TXNS_OVERVIEW_BILLING` |
+| `STRIPE_GET_V1_BILLING_PORTAL_CONFIGURATIONS_OVERVIEW_BILLING_PORTAL_CONFIGURATIONS` | `STRIPE_GET_V1_BILLING_PORTAL_CONFIGS_OVERVIEW_BILLING` |
+| `STRIPE_GET_V1_ENTITLEMENTS_ACTIVE_ENTITLEMENTS_ACTIVE_ENTITLEMENT` | `STRIPE_GET_V1_ENTITLEMENTS_ACTIVE_ENTITLEMENTS_ACTIVE` |
+| `STRIPE_GET_V1_FINANCIAL_CONNECTIONS_ACCOUNTS_OVERVIEW_FINANCIAL_CONNECTIONS_ACCOUNTS` | `STRIPE_GET_V1_FIN_CONNS_ACCOUNTS_OVERVIEW_FIN_CONNS_ACCOUNTS` |
+| `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD` | `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD` |
+| `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD2` | `STRIPE_GET_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD2` |
+| `STRIPE_GET_V1_QUOTES_COMPUTED_UPFRONT_LINE_ITEMS_LIST_ALL_QUOTES` | `STRIPE_GET_V1_QUOTES_COMPUTED_UPFRONT_LINE_ITEMS_LIST_ALL` |
+| `STRIPE_GET_V1_REPORTING_REPORT_TYPES_OVERVIEW_REPORTING_REPORT_TYPES` | `STRIPE_GET_V1_REPORTING_REPORT_TYPES_OVERVIEW_REPORTING` |
+| `STRIPE_GET_V1_TEST_HELPERS_TEST_CLOCKS_DELETE_A_TEST_TEST_HELPERS_TEST_CLOCKS` | `STRIPE_GET_V1_TEST_HELPERS_TEST_CLOCKS_DELETE_TEST_TEST` |
+| `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS_SUBSCRIPTION_EXPOSED_ID` | `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID` |
+| `STRIPE_POST_PAYMENT_RECORDS_ID_REPORT_PAYMENT_ATTEMPT_CANCELED` | `STRIPE_POST_PAYMENT_RECORDS_REPORT_ATTEMPT_CANCELED` |
+| `STRIPE_POST_PAYMENT_RECORDS_ID_REPORT_PAYMENT_ATTEMPT_INFORMATIONAL` | `STRIPE_POST_PAYMENT_RECORDS_REPORT_ATTEMPT_INFO` |
+| `STRIPE_POST_TAX_TRANSACTIONS_CREATE_FROM_CALCULATION_OVERVIEW` | `STRIPE_POST_TAX_TXNS_CREATE_FROM_CALCULATION_OVERVIEW` |
+| `STRIPE_POST_TERMINAL_READERS_CANCEL_ACTION_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_CANCEL_ACTION_SET_READER` |
+| `STRIPE_POST_TERMINAL_READERS_COLLECT_INPUTS_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_COLLECT_INPUTS_SET_READER` |
+| `STRIPE_POST_TERMINAL_READERS_CONFIRM_PAYMENT_INTENT_SET_READER_DISPLAY` | `STRIPE_POST_TERMINAL_READERS_CONFIRM_PAYMENT_INTENT_SET` |
+| `STRIPE_POST_TEST_HELPERS_CUSTOMERS_FUND_CASH_BALANCE_FUND_A_TEST` | `STRIPE_POST_TEST_HELPERS_CUSTOMERS_FUND_CASH_BALANCE_FUND` |
+| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_PRESENT_PAYMENT_METHOD` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_PRESENT` |
+| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_SUCCEED_INPUT_COLLECTION` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_SUCCEED` |
+| `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_TIMEOUT_INPUT_COLLECTION` | `STRIPE_POST_TEST_HELPERS_TERMINAL_READERS_READER_TIMEOUT` |
+| `STRIPE_POST_V1_BILLING_PORTAL_CONFIGURATIONS_OVERVIEW_BILLING_PORTAL_CONFIGURATIONS` | `STRIPE_POST_V1_BILLING_PORTAL_CONFIGS_OVERVIEW_BILLING` |
+| `STRIPE_POST_V1_PAYMENT_METHOD_CONFIGURATIONS_LIST_PAYMENT_METHOD2` | `STRIPE_POST_V1_PAYMENT_METHOD_CONFIGS_LIST_PAYMENT_METHOD2` |
+| `STRIPE_POST_V1_PAYMENT_METHOD_DOMAINS_PAYMENT_METHOD_DOMAINS2` | `STRIPE_POST_V1_PAYMENT_METHOD_DOMAINS_PAYMENT_METHOD` |
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_CANCELED_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_CANCELED` |
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_GUARANTEED_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_GUARANTEED` |
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_INFORMATIONAL_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_INFO` |
+| `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_PAYMENT_ATTEMPT_OVERVIEW` | `STRIPE_POST_V1_PAYMENT_RECORDS_REPORT_ATTEMPT` |
+| `STRIPE_POST_V1_TEST_HELPERS_CONFIRMATION_TOKENS_CREATE_A_TEST` | `STRIPE_POST_V1_TEST_HELPERS_CONFIRMATION_TOKENS_CREATE_TEST` |
+| `STRIPE_POST_V2_BILLING_METER_EVENT_ADJUSTMENTS_METER_EVENT_ADJUSTMENTS` | `STRIPE_POST_V2_BILLING_METER_EVENT_ADJUSTMENTS_METER_EVENT` |
-</Accordion>
-</Accordions>
+</details>
## Migration
diff --git a/docs/content/changelog/01-12-26-tool-router-improvements.mdx b/docs/content/changelog/01-12-26-tool-router-improvements.mdx
index d1fbc6610..78b230f2b 100644
--- a/docs/content/changelog/01-12-26-tool-router-improvements.mdx
+++ b/docs/content/changelog/01-12-26-tool-router-improvements.mdx
@@ -3,6 +3,8 @@ title: "Tool Router Improvements and New Features"
date: "2026-01-12"
---
+# Tool Router Improvements and New Features
+
## Version Information
### TypeScript/JavaScript
@@ -10,7 +12,7 @@ date: "2026-01-12"
- Version: `0.3.4` to `0.4.0`
### Python
-- Package: `composio-core` and provider packages
+- Package: `composio-core` and provider packages
- Version: `0.10.4` to `0.10.5`
## New Features
@@ -21,10 +23,6 @@ Added `waitForConnections` (TypeScript) / `wait_for_connections` (Python) proper
**TypeScript:**
```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your-api-key' });
-const userId = 'user_123';
-// ---cut---
const session = await composio.toolRouter.create(userId, {
manageConnections: {
enable: true,
@@ -52,10 +50,6 @@ Introduced new modifier types for better session-based tool execution: `SessionE
**TypeScript:**
```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your-api-key' });
-const session = await composio.toolRouter.create('user_123', { manageConnections: { enable: true } });
-// ---cut---
const tools = await session.tools({
modifySchema: ({ toolSlug, toolkitSlug, schema }) => schema,
beforeExecute: ({ toolSlug, toolkitSlug, sessionId, params }) => params,
@@ -71,7 +65,7 @@ from composio.core.models import before_execute_meta, after_execute_meta
def before_modifier(tool, toolkit, session_id, params):
return params
-@after_execute_meta
+@after_execute_meta
def after_modifier(tool, toolkit, session_id, response):
return response
@@ -84,9 +78,6 @@ Added `getRawToolRouterMetaTools` (TypeScript) / `get_raw_tool_router_meta_tools
**TypeScript:**
```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your-api-key' });
-// ---cut---
const metaTools = await composio.tools.getRawToolRouterMetaTools('session_123', {
modifySchema: ({ toolSlug, toolkitSlug, schema }) => {
// Customize schema
@@ -138,3 +129,4 @@ This release is fully backward compatible:
| Optimized tool execution | No | No | No |
All changes follow semantic versioning principles and maintain full backward compatibility.
+
diff --git a/docs/content/changelog/01-14-26-auth-config-patch-semantics.mdx b/docs/content/changelog/01-14-26-auth-config-patch-semantics.mdx
index 44d484925..ad5b4df3c 100644
--- a/docs/content/changelog/01-14-26-auth-config-patch-semantics.mdx
+++ b/docs/content/changelog/01-14-26-auth-config-patch-semantics.mdx
@@ -3,6 +3,8 @@ title: "True PATCH Semantics for Auth Config Updates"
date: "2026-01-14"
---
+# True PATCH Semantics for Auth Config Updates
+
## Version Information
### TypeScript/JavaScript
@@ -17,9 +19,9 @@ date: "2026-01-14"
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.
-<Callout type="warn">
+<Warning>
**Breaking Change**: If you relied on omitting fields to clear them, you must now explicitly send `null` or `[]`. See [Migration Guide](#migration-guide) below.
-</Callout>
+</Warning>
## What Changed
@@ -30,9 +32,9 @@ The `PATCH /api/v3/auth_configs/{id}` endpoint now implements proper partial upd
| `scopes` (type: default) | Cleared if omitted | Preserved if omitted |
| `restrict_to_following_tools` | Reset to `[]` if omitted | Preserved if omitted |
-<Callout type="info">
+<Note>
**Merge Behavior**: The `credentials` object is merged—send only the fields you want to change, and existing fields are preserved.
-</Callout>
+</Note>
## New Capabilities
@@ -40,27 +42,27 @@ The `PATCH /api/v3/auth_configs/{id}` endpoint now implements proper partial upd
Update just `client_secret` without resending `client_id` or other fields:
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
-<Tab value="Python">
-```python
+<CodeBlocks>
+```python title="Python SDK"
from composio import Composio
composio = Composio()
# Only send the field you want to update - other credentials are preserved
+
composio.auth_configs.update(
- "ac_yourAuthConfigId",
- options={
- "type": "custom",
- "credentials": {
- "client_secret": "new_rotated_secret",
- },
- },
+"ac_yourAuthConfigId",
+options={
+"type": "custom",
+"credentials": {
+"client_secret": "new_rotated_secret",
+},
+},
)
-```
-</Tab>
-<Tab value="TypeScript">
-```typescript
+
+````
+
+```typescript title="TypeScript SDK"
import { Composio } from "@composio/core";
const composio = new Composio();
@@ -72,35 +74,35 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
client_secret: "new_rotated_secret",
},
});
-```
-</Tab>
-</Tabs>
+````
+
+</CodeBlocks>
### Update Tool Restrictions Without Touching Credentials
Previously, this would fail because `credentials` was required. Now it works:
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
-<Tab value="Python">
-```python
+<CodeBlocks>
+```python title="Python SDK"
from composio import Composio
composio = Composio()
# Update tool restrictions - credentials are automatically preserved
+
composio.auth_configs.update(
- "ac_yourAuthConfigId",
- options={
- "type": "custom",
- "tool_access_config": {
- "tools_available_for_execution": ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],
- },
- },
+"ac_yourAuthConfigId",
+options={
+"type": "custom",
+"tool_access_config": {
+"tools_available_for_execution": ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],
+},
+},
)
-```
-</Tab>
-<Tab value="TypeScript">
-```typescript
+
+````
+
+```typescript title="TypeScript SDK"
import { Composio } from "@composio/core";
const composio = new Composio();
@@ -115,9 +117,9 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
toolsAvailableForExecution: ["GMAIL_SEND_EMAIL", "GMAIL_READ_EMAIL"],
},
});
-```
-</Tab>
-</Tabs>
+````
+
+</CodeBlocks>
## Migration Guide
@@ -134,27 +136,27 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
| `tool_access_config` | `"tool_access_config": {"tools_available_for_execution": []}` | `toolAccessConfig: { toolsAvailableForExecution: [] }` |
| `scopes` (default) | `"scopes": ""` | `scopes: ""` (via HTTP API) |
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
-<Tab value="Python">
-```python
+<CodeBlocks>
+```python title="Python SDK - Clear tool restrictions"
from composio import Composio
composio = Composio()
# Explicitly clear tool restrictions with empty array
+
composio.auth_configs.update(
- "ac_yourAuthConfigId",
- options={
- "type": "custom",
- "tool_access_config": {
- "tools_available_for_execution": [],
- },
- },
+"ac_yourAuthConfigId",
+options={
+"type": "custom",
+"tool_access_config": {
+"tools_available_for_execution": [],
+},
+},
)
-```
-</Tab>
-<Tab value="TypeScript">
-```typescript
+
+````
+
+```typescript title="TypeScript SDK - Clear tool restrictions"
import { Composio } from "@composio/core";
const composio = new Composio();
@@ -169,9 +171,9 @@ await composio.authConfigs.update("ac_yourAuthConfigId", {
toolsAvailableForExecution: [],
},
});
-```
-</Tab>
-</Tabs>
+````
+
+</CodeBlocks>
### Raw HTTP API
diff --git a/docs/content/changelog/01-20-26-file-modifier-anyof-support.mdx b/docs/content/changelog/01-20-26-file-modifier-anyof-support.mdx
index 5f10cc174..dbc0ab594 100644
--- a/docs/content/changelog/01-20-26-file-modifier-anyof-support.mdx
+++ b/docs/content/changelog/01-20-26-file-modifier-anyof-support.mdx
@@ -1,8 +1,10 @@
---
-title: "[Critical] File Upload/Download Fixes for anyOf, oneOf, and allOf Schemas"
+title: "File Upload/Download Fixes for latest tool with anyOf, oneOf, and allOf Schemas"
date: "2026-01-20"
---
+# [Critical] File Upload/Download Fixes for `latest` tool with anyOf, oneOf, and allOf Schemas
+
## Version Information
### TypeScript/JavaScript
@@ -17,9 +19,9 @@ date: "2026-01-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.
-<Callout type="info">
+<Note>
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.
-</Callout>
+</Note>
## What Changed
@@ -28,7 +30,6 @@ We recommend updating to version `0.5.3` (TypeScript) or `0.10.8` (Python) or la
File properties inside `anyOf`, `oneOf`, or `allOf` were not detected:
```typescript
-// @noErrors
// This schema's file_uploadable was NOT being processed
inputParameters: {
type: 'object',
@@ -53,7 +54,6 @@ inputParameters: {
File properties are now correctly detected and processed at any nesting level:
```typescript
-// @noErrors
// Now properly detected and transformed
inputParameters: {
type: 'object',
@@ -77,56 +77,48 @@ inputParameters: {
| Scenario | Before | After |
|----------|--------|-------|
-| `file_uploadable` in `anyOf` | Not detected | Works |
-| `file_uploadable` in `oneOf` | Not detected | Works |
-| `file_uploadable` in `allOf` | Not detected | Works |
-| `file_downloadable` in `anyOf` | Not detected | Works |
-| `file_downloadable` in `oneOf` | Not detected | Works |
-| `file_downloadable` in `allOf` | Not detected | Works |
-| Nested objects inside union types | Not detected | Works |
-| Array items with union types | Not detected | Works |
+| `file_uploadable` in `anyOf` | Not detected | ✅ Works |
+| `file_uploadable` in `oneOf` | Not detected | ✅ Works |
+| `file_uploadable` in `allOf` | Not detected | ✅ Works |
+| `file_downloadable` in `anyOf` | Not detected | ✅ Works |
+| `file_downloadable` in `oneOf` | Not detected | ✅ Works |
+| `file_downloadable` in `allOf` | Not detected | ✅ Works |
+| Nested objects inside union types | Not detected | ✅ Works |
+| Array items with union types | Not detected | ✅ Works |
## How to Update
### TypeScript/JavaScript
-<Tabs groupId="package-manager" items={['npm', 'pnpm', 'yarn']} persist>
-<Tab value="npm">
-```bash
+<CodeBlocks>
+```bash title="npm"
npm update @composio/core@latest
```
-</Tab>
-<Tab value="pnpm">
-```bash
+
+```bash title="pnpm"
pnpm update @composio/core@latest
```
-</Tab>
-<Tab value="yarn">
-```bash
+
+```bash title="yarn"
yarn upgrade @composio/core@latest
```
-</Tab>
-</Tabs>
+</CodeBlocks>
### Python
-<Tabs groupId="python-package-manager" items={['pip', 'uv', 'poetry']} persist>
-<Tab value="pip">
-```bash
+<CodeBlocks>
+```bash title="pip"
pip install --upgrade composio
```
-</Tab>
-<Tab value="uv">
-```bash
+
+```bash title="uv"
uv pip install --upgrade composio
```
-</Tab>
-<Tab value="poetry">
-```bash
+
+```bash title="poetry"
poetry update composio
```
-</Tab>
-</Tabs>
+</CodeBlocks>
## Backward Compatibility
diff --git a/docs/content/changelog/01-20-26-file-ttl.mdx b/docs/content/changelog/01-20-26-file-ttl.mdx
index 61c6f33b0..39f1818ec 100644
--- a/docs/content/changelog/01-20-26-file-ttl.mdx
+++ b/docs/content/changelog/01-20-26-file-ttl.mdx
@@ -3,6 +3,8 @@ title: "File handling in tool execution now uses presigned URLs"
date: "2026-01-20"
---
+# File handling in tool execution now uses presigned URLs
+
## Summary
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.
diff --git a/docs/content/changelog/01-21-26-initiate-active-status-filter.mdx b/docs/content/changelog/01-21-26-initiate-active-status-filter.mdx
new file mode 100644
index 000000000..9fc00ec8b
--- /dev/null
+++ b/docs/content/changelog/01-21-26-initiate-active-status-filter.mdx
@@ -0,0 +1,49 @@
+---
+title: "Connected Account Initiate Now Filters by ACTIVE Status"
+date: "2026-01-21"
+---
+
+# Connected Account Initiate Now Filters by ACTIVE Status
+
+## Version Information
+
+### TypeScript/JavaScript
+- Package: `@composio/core`
+- Version: `0.5.4`+
+
+### Python
+- Package: `composio`
+- Version: `0.10.9`+
+
+---
+
+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.
+
+## What Changed
+
+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.
+
+### Before (Bug)
+
+```typescript
+// Expired accounts would incorrectly trigger ComposioMultipleConnectedAccountsError
+await composio.connectedAccounts.initiate(userId, authConfigId);
+// ❌ Error: Multiple connected accounts found (even if they're all expired)
+```
+
+### After (Fixed)
+
+```typescript
+// Only ACTIVE accounts are considered
+await composio.connectedAccounts.initiate(userId, authConfigId);
+// ✅ Works - expired/inactive accounts are ignored
+```
+
+## Affected SDKs
+
+- **TypeScript**: `@composio/core`
+- **Python**: `composio`
+
+## Backward Compatibility
+
+This is a bug fix with no breaking changes. The behavior now matches the expected intent of the multiple accounts check.
diff --git a/docs/content/changelog/01-22-26-experimental-assistive-prompts.mdx b/docs/content/changelog/01-22-26-experimental-assistive-prompts.mdx
new file mode 100644
index 000000000..722451022
--- /dev/null
+++ b/docs/content/changelog/01-22-26-experimental-assistive-prompts.mdx
@@ -0,0 +1,118 @@
+---
+title: "Experimental Assistive Prompts and API Updates"
+date: "2026-01-22"
+---
+
+# Experimental Assistive Prompts and API Updates
+
+## Version Information
+
+### TypeScript/JavaScript
+- Package: `@composio/core`
+- Version: `0.5.5`+
+
+### Python
+- Package: `composio`
+- Version: `0.10.10`+
+
+## New Features
+
+### Experimental Assistive Prompt Configuration
+
+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.
+
+<Warning>
+This is an experimental feature. The API may change or be removed in future versions.
+</Warning>
+
+<CodeBlocks>
+```python title="Python SDK"
+from composio import Composio
+
+composio = Composio()
+
+session = composio.tool_router.create(
+ user_id="user_123",
+ toolkits=["github"],
+ experimental={
+ "assistive_prompt": {
+ "user_timezone": "America/New_York",
+ }
+ },
+)
+
+# Access the generated assistive prompt
+if session.experimental:
+ print(session.experimental.assistive_prompt)
+```
+
+```typescript title="TypeScript SDK"
+import { Composio } from "@composio/core";
+
+const composio = new Composio();
+
+const session = await composio.toolRouter.create("user_123", {
+ toolkits: ["github"],
+ experimental: {
+ assistivePrompt: {
+ userTimezone: "America/New_York",
+ },
+ },
+});
+
+// Access the generated assistive prompt
+if (session.experimental) {
+ console.log(session.experimental.assistivePrompt);
+}
+```
+</CodeBlocks>
+
+<Note>
+The `experimental` field is only available on sessions created with `create()`. Sessions retrieved with `use()` do not include the experimental data.
+</Note>
+
+### Toolkit Endpoint Method
+
+The toolkit retrieve response now includes `getCurrentUserEndpointMethod` (TypeScript) / `get_current_user_endpoint_method` (Python) to indicate the HTTP method for the current user endpoint.
+
+## Breaking Changes
+
+### Trigger Pagination: `page` Replaced with `cursor`
+
+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.
+
+<CodeBlocks>
+```python title="Python SDK"
+# Before (deprecated)
+triggers = composio.triggers.list_active(page=1, limit=10)
+
+# After
+triggers = composio.triggers.list_active(cursor="cursor_string", limit=10)
+# Use response.next_cursor for the next page
+```
+
+```typescript title="TypeScript SDK"
+// Before (deprecated)
+const triggers = await composio.triggers.listActive({ page: 1, limit: 10 });
+
+// After
+const triggers = await composio.triggers.listActive({ cursor: "cursor_string", limit: 10 });
+// Use response.nextCursor for the next page
+```
+</CodeBlocks>
+
+## Impact Summary
+
+| Change | Runtime Breaking | TypeScript Breaking | Migration Required |
+|--------|------------------|---------------------|-------------------|
+| Experimental assistive prompts | No | No | No |
+| `getCurrentUserEndpointMethod` field | No | No | No |
+| `page` → `cursor` in triggers | Yes | Yes | Yes (if using `page`) |
+
+## Migration Guide
+
+If you are using the `page` parameter in `listActive` / `list_active`:
+
+1. Replace `page` with `cursor`
+2. For the first request, omit the `cursor` parameter or pass `undefined`/`None`
+3. Use the `nextCursor` / `next_cursor` from the response for subsequent requests