209
If you just want to call a tool without using any framework or LLM provider, you can use the `execute` method directly.
210
211
<Callout type="warn">
212
-**A toolkit version is required for direct execution** — calling `tools.execute()` without one raises `ToolVersionRequiredError`. Set versions for your toolkits at SDK initialization (shown below), pass `version="..."` per call, or use environment variables. Use `"latest"` unless you need to pin — see [toolkit versioning](/docs/tools-direct/toolkit-versioning) for the tradeoffs and how to [look up a toolkit's versions](/docs/tools-direct/toolkit-versioning#managing-versions).
212
+**A toolkit version is required for direct execution** — calling `tools.execute()` without one raises `ToolVersionRequiredError`, and `"latest"` alone is not accepted here. Two ways to satisfy it:
213
+
214
+- **An LLM or agent consumes the outputs:** keep `"latest"` and pass `dangerously_skip_version_check=True` (TypeScript: `dangerouslySkipVersionCheck: true`) on the execute call — you always run the newest tools, and the flag's name is the reminder that output schemas can change between releases.
215
+- **Your code parses the outputs:** pin a dated version — look it up with `composio.toolkits.get(slug="...").meta.version` or in the [Toolkits catalog](/toolkits), and pass it at SDK initialization or per call via `version="..."`.
216
+
217
+See [toolkit versioning](/docs/tools-direct/toolkit-versioning) for the full tradeoffs.
218
</Callout>
219
220
<Callout type="info">
244
result = composio.tools.execute(
245
"GITHUB_LIST_STARGAZERS",
246
user_id=user_id,
242
- arguments={"owner": "ComposioHQ", "repo": "composio", "page": 1, "per_page": 5}
247
+ arguments={"owner": "ComposioHQ", "repo": "composio", "page": 1, "per_page": 5},
248
+ # "latest" requires this opt-in; to pin instead, pass version=composio.toolkits.get(slug="github").meta.version
249
+ dangerously_skip_version_check=True,
250
)
251
print(result)
252
```
272
"page": 1,
273
"per_page": 5
274
},
275
+ // "latest" requires this opt-in; to pin instead, pass version from (await composio.toolkits.get("github")).meta.version
276
+ dangerouslySkipVersionCheck: true,
277
});
278
console.log('GitHub stargazers:', JSON.stringify(result, null, 2));
279
```
370
slug="GOOGLEDRIVE_UPLOAD_FILE",
371
user_id="user-1235***",
372
arguments={"file_to_upload": os.path.join(os.getcwd(), "document.pdf")},
373
+ dangerously_skip_version_check=True, # required when running "latest"
374
)
375
376
print(result) # Print Google Drive file details
392
userId: 'user-4235***',
393
arguments: {
394
file_to_upload: path.join(__dirname, 'document.pdf')
385
- }
395
+ },
396
+ dangerouslySkipVersionCheck: true, // required when running "latest"
397
});
398
399
console.log(result.data); // Contains Google Drive file details
415
"body": "Please find the report attached.",
416
"attachment": "https://example.com/report.pdf",
417
},
418
+ dangerously_skip_version_check=True, # required when running "latest"
419
)
420
```
421
</Tab>
435
body: 'Please find the report attached.',
436
attachment: 'https://example.com/report.pdf',
437
},
438
+ dangerouslySkipVersionCheck: true, // required when running "latest"
439
});
440
```
441
</Tab>
459
"GOOGLEDRIVE_DOWNLOAD_FILE",
460
user_id="user-1235***",
461
arguments={"file_id": "your_file_id"},
462
+ dangerously_skip_version_check=True, # required when running "latest"
463
)
464
465
# Result includes local file path
481
userId: 'user-1235***',
482
arguments: {
483
file_id: 'your-file-id'
470
- }
484
+ },
485
+ dangerouslySkipVersionCheck: true, // required when running "latest"
486
});
487
488
// Result includes local file path
554
{
555
userId: 'user-4235***',
556
arguments: { file_to_upload: path.join(__dirname, 'document.pdf') },
557
+ dangerouslySkipVersionCheck: true, // required when running "latest"
558
},
559
{ beforeFileUpload }
560
);
580
"GOOGLEDRIVE_UPLOAD_FILE",
581
{"file_to_upload": os.path.join(os.getcwd(), "document.pdf")},
582
user_id="user-1235***",
583
+ dangerously_skip_version_check=True, # required when running "latest"
584
modifiers=[audit_path],
585
)
586
```
619
"GOOGLEDRIVE_UPLOAD_FILE",
620
user_id="user-1",
621
arguments={"file_to_upload": prestaged_descriptor},
622
+ dangerously_skip_version_check=True, # required when running "latest"
623
)
624
```
625
</Tab>
647
await composio.tools.execute('GOOGLEDRIVE_UPLOAD_FILE', {
648
userId: 'user-1',
649
arguments: { file_to_upload: fileData },
650
+ dangerouslySkipVersionCheck: true, // required when running "latest"
651
});
652
```
653
</Tab>