Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
mdx 103 lines 3.21 KB
Raw
1 ---
2 title: "Typed Responses Across Toolkits"
3 description: "57 toolkits now return strongly typed objects instead of generic response_data"
4 date: "2025-12-10"
5 ---
6
7 We've updated many toolkits so their outputs are now strongly typed objects instead of a generic `response_data` blob, meaning tools like Outlook, HubSpot, Notion, etc. now return well-shaped, documented fields you can rely on directly in your code and agents. These improvements apply to the latest toolkit versions—see our [toolkit versioning docs](/docs/tools-direct/toolkit-versioning) for how versions are managed.
8
9 <Callout type="warn">
10 **Breaking Change for `latest` Version**
11
12 If you're using the `latest` version and your code post-processes the old `response_data` structure, you'll need to update your code to work with the new flattened, typed response schemas.
13 </Callout>
14
15 ### Why This Matters
16 - Better developer experience for direct execute: clear fields and types
17 - Improved agent performance: flatter output shapes with explicit fields reduce nesting and invalid params
18 - Clearer docs and type safety: richer metadata for IDEs and autocomplete
19
20 <Accordions>
21 <Accordion title="Impacted Toolkits (57 total)">
22
23 #### Communication & Collaboration
24 discordbot, microsoft_teams, slack, zoom
25
26 #### CRM & Sales
27 apollo, attio, hubspot, instantly, intercom, kommo, salesforce
28
29 #### Productivity & Docs
30 coda, confluence, googledocs, googletasks, notion, todoist
31
32 #### Marketing & Social Media
33 facebook, instagram, klaviyo, linkedin, metaads, reddit, tiktok
34
35 #### E-commerce & Payments
36 brex, quickbooks, ramp, shopify, square, stripe, xero
37
38 #### Project Management
39 clickup, linear
40
41 #### Design & Creative
42 canva, figma
43
44 #### Data & Analytics
45 ahrefs, airtable, apify, exa, pplx, serpapi, tavily
46
47 #### Email & Calendar
48 calendly, outlook
49
50 #### Storage & Files
51 one_drive
52
53 #### Web Tools
54 firecrawl, fireflies, google_maps, google_search_console
55
56 #### AI & Media
57 elevenlabs, heygen, lmnt, mem0
58
59 #### Customer Support
60 freshdesk, zendesk
61
62 #### Video & Content
63 youtube
64
65 </Accordion>
66 </Accordions>
67
68 ### Before vs After
69 **Previous (generic, version `20251202_00`):**
70 ```json
71 {
72 "data": {
73 "response_data": { "...": "..." }
74 },
75 "successful": true
76 }
77 ```
78
79 **Now (typed example – Outlook List Messages, version `20251209_00`):**
80 ```json
81 {
82 "data": {
83 "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/messages",
84 "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/messages?$skip=10",
85 "value": [
86 {
87 "id": "abc123",
88 "subject": "Hi there",
89 "from": { "emailAddress": { "address": "a@b.com", "name": "Alice" } },
90 "hasAttachments": true
91 }
92 ]
93 },
94 "successful": true
95 }
96 ```
97
98 For the exact field mapping per toolkit, open `dashboard.composio.dev` → Toolkits → List Messages (or the relevant tool).
99
100 ### Migration Notes
101 - Breaking change for consumers on the `latest` version who post-process the old nested `response_data` shape: outputs are now flattened and explicitly typed.
102 - New and modified fields include richer descriptions and examples; some legacy placeholders were removed.
103 - Re-fetch schemas for your tool/version to see the typed definitions. Use the toolkit view in `dashboard.composio.dev` for authoritative field details.