v1
latestOpenAPI 3.0.02026-07-26870415.2 KBcustom_tools
List custom tool runtimes
Returns the supported custom tool runtimes (Python, JavaScript) with the exact entrypoint signature, required return shape, starter template, built-in modules, and auto-installable third-party packages for each. Read this before authoring code for create/update.
get/v1/custom-tools/runtimes
Response
Supported custom tool runtimes
Example response
{
"data": [
{
"language": "python",
"display_name": "Python",
"file_extension": "py",
"package_manager": "pip",
"entrypoint_signature": "def main(**params) -> dict",
"return_contract": "Return a dict containing a string `message` key. Optionally include `rawData` for structured data the agent can read. Example: `return {\"message\": \"Found 3 results\", \"rawData\": {...}}`.",
"starter_template": "def main(**params):\n result = \"Hello from custom tool!\"\n return {\"message\": result, \"rawData\": {\"any\": \"additional data\"}}",
"builtin_modules": [
"json",
"math",
"datetime",
"re",
"urllib"
],
"available_packages": [
"httpx",
"numpy",
"pandas",
"requests"
]
},
{
"language": "javascript",
"display_name": "JavaScript",
"file_extension": "js",
"package_manager": "bun",
"entrypoint_signature": "async function main(params) -> object",
"return_contract": "Return an object containing a string `message` key. Optionally include `rawData` for structured data the agent can read. Example: `return { message: 'Found 3 results', rawData: {...} }`.",
"starter_template": "async function main(params) {\n const result = \"Hello from custom tool!\";\n return { message: result, rawData: { any: \"additional data\" } };\n}",
"builtin_modules": [
"fs",
"path",
"crypto",
"https"
],
"available_packages": []
}
]
}