Tests a tool by executing it with the provided parameters. This allows you
to verify that your webhook is configured correctly and returns the expected
response. You can also use validate_only to test parameter validation
without actually calling the webhook.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"iwy.ai Documentation","colors":{"primary":"#300040","light":"#e77ff5","dark":"#300040"},"logo":{"light":"https://mintcdn.com/iwy/G25hY7NOv8_8zjPz/logo/light.svg?fit=max\u0026auto=format\u0026n=G25hY7NOv8_8zjPz\u0026q=85\u0026s=90364bd7576f99beaec49d7b01a6b375","dark":"https://mintcdn.com/iwy/G25hY7NOv8_8zjPz/logo/dark.svg?fit=max\u0026auto=format\u0026n=G25hY7NOv8_8zjPz\u0026q=85\u0026s=838712dacbfc0f01cfc065bccd6aa52f"},"favicon":"/favicon.svg","api":{"playground":{}},"background":{"image":"https://mintlify.s3.us-west-1.amazonaws.com/iwy/images/background.png","color":{"light":"#fefdf6","dark":"#1a1a1a"}},"navbar":{"links":[{"label":"Homepage","href":"https://www.iwy.ai"},{"label":"Contact","href":"https://www.iwy.ai/contact"}],"primary":{"type":"button","label":"Start Building","href":"https://app.iwy.ai"}},"footer":{"socials":{"github":"https://github.com/iwy-ai"}},"styling":{"codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","mcp"]},"navigation":{"global":{"anchors":[{"anchor":"Homepage","icon":"house","href":"https://www.iwy.ai"},{"anchor":"Dashboard","icon":"gear","href":"https://app.iwy.ai"},{"anchor":"GitHub","icon":"github","href":"https://github.com/iwy-ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"iwy","hasAudioNarration":false,"actualSubdomain":"iwy","customDomains":["docs.iwy.ai"],"gitSource":{"type":"github","owner":"iwy-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e7388d1fcd719df04d2a","collectionId":"6cce78fc-8db1-4542-b3be-1b66c34e1fbe","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21e7388d1fcd719df04d2a:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":19},{"language":"default","tag":"Tools","count":7},{"language":"default","tag":"Permanent Agents","count":6},{"language":"default","tag":"Overview","count":6},{"language":"default","tag":"Connect \u0026 Embed","count":5},{"language":"default","tag":"Single-Use Agents","count":2},{"language":"default","tag":"Sessions","count":2},{"language":"default","tag":"Examples","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/dashboard/tools/test-tool-execution","slug":"/api-reference/dashboard/tools/test-tool-execution","pageMetadata":{"openapi":"post /tool/{id}/test","title":"Test tool execution","description":"Tests a tool by executing it with the provided parameters. This allows you\nto verify that your webhook is configured correctly and returns the expected\nresponse. You can also use `validate_only` to test parameter validation\nwithout actually calling the webhook.\n\n## Use Cases\n- Verify webhook configuration\n- Debug failed tool calls\n- Test parameter validation\n- Develop and iterate on webhooks\n","href":"/api-reference/dashboard/tools/test-tool-execution","hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h2: \"h2\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Tests a tool by executing it with the provided parameters. This allows you\\nto verify that your webhook is configured correctly and returns the expected\\nresponse. You can also use \", _jsx(_components.code, {\n children: \"validate_only\"\n }), \" to test parameter validation\\nwithout actually calling the webhook.\"]\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Use Cases\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Verify webhook configuration\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Debug failed tool calls\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Test parameter validation\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Develop and iterate on webhooks\"\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"openapi":"post /tool/{id}/test","title":"Test tool execution","description":"Tests a tool by executing it with the provided parameters. This allows you\nto verify that your webhook is configured correctly and returns the expected\nresponse. You can also use `validate_only` to test parameter validation\nwithout actually calling the webhook.\n\n## Use Cases\n- Verify webhook configuration\n- Debug failed tool calls\n- Test parameter validation\n- Develop and iterate on webhooks\n","href":"/api-reference/dashboard/tools/test-tool-execution","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Tools"],"summary":"Test tool execution","description":"Tests a tool by executing it with the provided parameters. This allows you\nto verify that your webhook is configured correctly and returns the expected\nresponse. You can also use `validate_only` to test parameter validation\nwithout actually calling the webhook.\n\n## Use Cases\n- Verify webhook configuration\n- Debug failed tool calls\n- Test parameter validation\n- Develop and iterate on webhooks\n","operationId":"testTool","parameters":["77a300ab-bd60-41d5-b410-d3686f1bf3bc"],"requestBody":"0db16633-fa96-4db9-8cdc-1e2f28cd9362","responses":{"200":"3d2b1986-4f37-4bab-bffc-420bcf41b11a","400":"07281da1-8ee1-44b5-b460-c2ab8124907f","401":"5e256719-3223-4b71-b90c-bd3002264359","404":"e3f1e88e-7254-40c8-a05e-7cde609c4246","408":"45893158-3c53-4d58-a6d9-c9f15442d3d0","500":"4d2fc523-9679-4b4c-be54-3431c0e3b40e","502":"f81f3513-d34a-473d-bbe8-094bf1e5608a"},"method":"post","type":"path","servers":["ec365b07-20c7-48bc-b6f6-4ed6eedfa2f7"],"security":["176ecb09-507f-472f-be15-4aa5980a65b4"],"path":"/tool/{id}/test","baseUrlOptions":["https://api.iwy.ai/v1"],"title":"Test tool execution","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"77a300ab-bd60-41d5-b410-d3686f1bf3bc":{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the tool","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The unique identifier (UUID) of the tool","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"dcfae097-1b37-4444-bb0c-1a6abb0320fd"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["parameters"],"properties":{"parameters":{"type":"object","description":"Parameters to pass to the tool","additionalProperties":true,"example":{"city":"Paris"},"isRequired":true,"uniqueKey":"parameters","typeLabel":"object"},"validate_only":{"type":"boolean","description":"Only validate parameters without calling webhook","default":false,"uniqueKey":"validate_only","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"full_test":{"title":"full_test","value":{"parameters":{"city":"Paris"}}},"validate_only":{"title":"validate_only","value":{"parameters":{"city":"Paris"},"validate_only":true}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"3d2b1986-4f37-4bab-bffc-420bcf41b11a":{"description":"Tool test executed successfully","content":{"application/json":{"schema":{"type":"object","required":["success"],"properties":{"success":{"type":"boolean","description":"Whether the test was successful","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"execution_time_ms":{"type":"integer","description":"Execution time in milliseconds","uniqueKey":"execution_time_ms","typeLabel":"integer"},"validation":{"type":"string","description":"Validation status (for validate_only requests)","uniqueKey":"validation","typeLabel":"string"},"message":{"type":"string","description":"Human-readable message","uniqueKey":"message","typeLabel":"string"},"tool":{"type":"object","description":"Tool information","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"tool.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"tool.name","typeLabel":"string"}},"uniqueKey":"tool","typeLabel":"object"},"request_sent":{"type":"object","description":"Details of the request sent to webhook","properties":{"url":{"type":"string","uniqueKey":"request_sent.url","typeLabel":"string"},"method":{"type":"string","uniqueKey":"request_sent.method","typeLabel":"string"},"headers":{"type":"object","additionalProperties":true,"uniqueKey":"request_sent.headers","typeLabel":"object"},"payload":{"type":"object","uniqueKey":"request_sent.payload","typeLabel":"object"}},"uniqueKey":"request_sent","typeLabel":"object"},"response_received":{"type":"object","description":"Response from the webhook","properties":{"status":{"type":"integer","uniqueKey":"response_received.status","typeLabel":"integer"},"status_text":{"type":"string","uniqueKey":"response_received.status_text","typeLabel":"string"},"headers":{"type":"object","additionalProperties":true,"uniqueKey":"response_received.headers","typeLabel":"object"},"body":{"type":"object","uniqueKey":"response_received.body","typeLabel":"object"},"content_type":{"type":"string","uniqueKey":"response_received.content_type","typeLabel":"string"}},"uniqueKey":"response_received","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","value":{"success":true,"execution_time_ms":1234,"tool":{"id":"dcfae097-1b37-4444-bb0c-1a6abb0320fd","name":"get_weather"},"request_sent":{"url":"https://webhook.example.com/weather","method":"POST","headers":{"Content-Type":"application/json","x-api-key":"[REDACTED]"},"payload":{"tool_id":"dcfae097-1b37-4444-bb0c-1a6abb0320fd","tool_name":"get_weather","parameters":{"city":"Paris"}}},"response_received":{"status":200,"status_text":"OK","headers":{"content-type":"application/json","content-length":"256"},"body":{"temperature":18,"conditions":"Partly cloudy","humidity":65},"content_type":"application/json"}}},"validation_only":{"title":"validation_only","value":{"success":true,"validation":"passed","message":"Parameters are valid according to the tool schema"}}},"exampleType":"examples"}},"exampleType":"examples"},"07281da1-8ee1-44b5-b460-c2ab8124907f":{"description":"Parameter validation failed","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Error message","example":"Parameter validation failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional error details","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"execution_time_ms":{"type":"integer","description":"Execution time before error occurred","uniqueKey":"execution_time_ms","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Parameter validation failed","details":{"missing_required":["city"],"invalid_params":{"units":"Must be one of: celsius, fahrenheit"}}},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Parameter validation failed","details":{"missing_required":["city"],"invalid_params":{"units":"Must be one of: celsius, fahrenheit"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"5e256719-3223-4b71-b90c-bd3002264359":{"description":"Authentication failed - invalid or missing API key","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Error message","example":"Parameter validation failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional error details","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"execution_time_ms":{"type":"integer","description":"Execution time before error occurred","uniqueKey":"execution_time_ms","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Unauthorized","details":"Invalid or missing API key"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Unauthorized","details":"Invalid or missing API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"e3f1e88e-7254-40c8-a05e-7cde609c4246":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Error message","example":"Parameter validation failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional error details","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"execution_time_ms":{"type":"integer","description":"Execution time before error occurred","uniqueKey":"execution_time_ms","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Not found","details":"The requested resource does not exist"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Not found","details":"The requested resource does not exist"}}},"exampleType":"examples"}},"exampleType":"examples"},"45893158-3c53-4d58-a6d9-c9f15442d3d0":{"description":"Request timeout","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Error message","example":"Parameter validation failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional error details","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"execution_time_ms":{"type":"integer","description":"Execution time before error occurred","uniqueKey":"execution_time_ms","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Request timeout","execution_time_ms":20000,"details":"Request exceeded 20s timeout"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Request timeout","execution_time_ms":20000,"details":"Request exceeded 20s timeout"}}},"exampleType":"examples"}},"exampleType":"examples"},"4d2fc523-9679-4b4c-be54-3431c0e3b40e":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Error message","example":"Parameter validation failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional error details","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"execution_time_ms":{"type":"integer","description":"Execution time before error occurred","uniqueKey":"execution_time_ms","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Internal server error","details":"An unexpected error occurred"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Internal server error","details":"An unexpected error occurred"}}},"exampleType":"examples"}},"exampleType":"examples"},"f81f3513-d34a-473d-bbe8-094bf1e5608a":{"description":"Network error","content":{"application/json":{"schema":{"type":"object","required":["success","error"],"properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Error message","example":"Parameter validation failed","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"oneOf":[{"type":"string","description":"Additional error details","uniqueKey":"details.oneOf.0","typeLabel":"string"},{"type":"object","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"object"}],"uniqueKey":"details","typeLabel":"string | object"},"execution_time_ms":{"type":"integer","description":"Execution time before error occurred","uniqueKey":"execution_time_ms","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"error":"Network error","execution_time_ms":1567,"details":"getaddrinfo ENOTFOUND webhook.example.com"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"Network error","execution_time_ms":1567,"details":"getaddrinfo ENOTFOUND webhook.example.com"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"176ecb09-507f-472f-be15-4aa5980a65b4":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your iwy Service API Key. Find it at [app.iwy.ai/settings](https://app.iwy.ai/settings).\n\nInclude it in the Authorization header:\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n","scopes":[]}}},"servers":{"ec365b07-20c7-48bc-b6f6-4ed6eedfa2f7":{"url":"https://api.iwy.ai/v1","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Your iwy Service API Key. Find it at [app.iwy.ai/settings](https://app.iwy.ai/settings).\n\nInclude it in the Authorization header:\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your iwy Service API Key. Find it at [app.iwy.ai/settings](https://app.iwy.ai/settings).\n\nInclude it in the Authorization header:\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"iwy","siteName":"iwy.ai Documentation","title":"Test tool execution - iwy.ai Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-27T14:46:14.457Z","originalFileLocation":"api-reference/dashboard/tools/test-tool-execution.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Tests a tool by executing it with the provided parameters. This allows you to verify that your webhook is configured correctly and returns the expected response. You can also use validate_only to test parameter validation without actually calling the webhook. ## Use Cases - Verify webhook configuration - Debug failed tool calls - Test parameter validation - Develop and iterate on webhooks\">\u003cmeta data-mint-head name=\"application-name\" content=\"iwy.ai Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Test tool execution - iwy.ai Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Tests a tool by executing it with the provided parameters. This allows you to verify that your webhook is configured correctly and returns the expected response. You can also use validate_only to test parameter validation without actually calling the webhook. ## Use Cases - Verify webhook configuration - Debug failed tool calls - Test parameter validation - Develop and iterate on webhooks\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"iwy.ai Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://iwy.mintlify.app/_mintlify/api/og/v2?division=Tools\u0026amp;title=Test+tool+execution\u0026amp;description=Tests+a+tool+by+executing+it+with+the+provided+parameters.+This+allows+you%0Ato+verify+that+your+webhook+is+configured+correctly+and+returns+the+expected%0Aresponse\u0026amp;theme=44bc1d1355f9460d40fa2ecc\u0026amp;signature=e092001bfeb155060fe17aaefa7f85602c81a50891d865312a7c021063d0e77b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Test tool execution - iwy.ai Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Tests a tool by executing it with the provided parameters. This allows you to verify that your webhook is configured correctly and returns the expected response. You can also use validate_only to test parameter validation without actually calling the webhook. ## Use Cases - Verify webhook configuration - Debug failed tool calls - Test parameter validation - Develop and iterate on webhooks\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://iwy.mintlify.app/_mintlify/api/og/v2?division=Tools\u0026amp;title=Test+tool+execution\u0026amp;description=Tests+a+tool+by+executing+it+with+the+provided+parameters.+This+allows+you%0Ato+verify+that+your+webhook+is+configured+correctly+and+returns+the+expected%0Aresponse\u0026amp;theme=44bc1d1355f9460d40fa2ecc\u0026amp;signature=e092001bfeb155060fe17aaefa7f85602c81a50891d865312a7c021063d0e77b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/iwy/dzp0S6E4dNydtu5G/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"iwy.ai Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#300040\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/dashboard/tools/test-tool-execution.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.iwy.ai/#organization\",\"name\":\"iwy.ai Documentation\",\"url\":\"https://docs.iwy.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/iwy/G25hY7NOv8_8zjPz/logo/light.svg?fit=max\u0026auto=format\u0026n=G25hY7NOv8_8zjPz\u0026q=85\u0026s=90364bd7576f99beaec49d7b01a6b375\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.iwy.ai#website\",\"name\":\"iwy.ai Documentation\",\"url\":\"https://docs.iwy.ai\",\"publisher\":{\"@id\":\"https://docs.iwy.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution#webpage\",\"url\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution\",\"name\":\"Test tool execution\",\"description\":\"Tests a tool by executing it with the provided parameters. This allows you to verify that your webhook is configured correctly and returns the expected response. You can also use validate_only to test parameter validation without actually calling the webhook. ## Use Cases - Verify webhook configuration - Debug failed tool calls - Test parameter validation - Develop and iterate on webhooks\",\"dateModified\":\"2026-01-27T14:46:14.457Z\",\"isPartOf\":{\"@id\":\"https://docs.iwy.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://docs.iwy.ai/api-reference/dashboard/tools/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Test tool execution\",\"item\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution#apireference\",\"headline\":\"Test tool execution\",\"name\":\"Test tool execution\",\"description\":\"Tests a tool by executing it with the provided parameters. This allows you to verify that your webhook is configured correctly and returns the expected response. You can also use validate_only to test parameter validation without actually calling the webhook. ## Use Cases - Verify webhook configuration - Debug failed tool calls - Test parameter validation - Develop and iterate on webhooks\",\"url\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution\",\"mainEntityOfPage\":{\"@id\":\"https://docs.iwy.ai/api-reference/dashboard/tools/test-tool-execution#webpage\"},\"dateModified\":\"2026-01-27T14:46:14.457Z\",\"publisher\":{\"@id\":\"https://docs.iwy.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.iwy.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"iwy.ai Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"iwy.ai Documentation","nav":{"global":{"anchors":[{"anchor":"Homepage","icon":"house","href":"https://www.iwy.ai"},{"anchor":"Dashboard","icon":"gear","href":"https://app.iwy.ai"},{"anchor":"GitHub","icon":"github","href":"https://github.com/iwy-ai"}]},"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/common-use-cases"}]},{"tab":"Connect \u0026 Embed","pages":[{"title":"Connect \u0026 Embed","href":"/connect-embed"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/api-reference"}]},{"group":"Single-Use Agents","pages":[{"title":"Single-Use Agents","href":"/api-reference/code-first/overview"},{"openapi":"post /ephemeral-agent","title":"Create ephemeral agent","href":"/api-reference/code-first/create-ephemeral-agent"}]},{"group":"Permanent Agents","pages":[{"title":"Permanent Agents","href":"/api-reference/dashboard/overview"},{"openapi":"get /agent","title":"List all agents","href":"/api-reference/dashboard/agents/list-all-agents"},{"openapi":"post /agent","title":"Create a new agent","href":"/api-reference/dashboard/agents/create-a-new-agent"},{"openapi":"get /agent/{id}","title":"Get agent by ID","href":"/api-reference/dashboard/agents/get-agent-by-id"},{"openapi":"patch /agent/{id}","title":"Update agent configuration","href":"/api-reference/dashboard/agents/update-agent-configuration"},{"openapi":"delete /agent/{id}","title":"Delete agent","href":"/api-reference/dashboard/agents/delete-agent"}]},{"group":"Tools","pages":[{"title":"Tools","href":"/api-reference/dashboard/tools/overview"},{"openapi":"get /tool","title":"List all tools","href":"/api-reference/dashboard/tools/list-all-tools"},{"openapi":"post /tool","title":"Create a new tool","href":"/api-reference/dashboard/tools/create-a-new-tool"},{"openapi":"get /tool/{id}","title":"Get tool by ID","href":"/api-reference/dashboard/tools/get-tool-by-id"},{"openapi":"patch /tool/{id}","title":"Update tool configuration","href":"/api-reference/dashboard/tools/update-tool-configuration"},{"openapi":"delete /tool/{id}","title":"Delete tool","description":"Permanently deletes the specified tool. This action cannot be undone.\nAgents using this tool will no longer be able to call it.\n","href":"/api-reference/dashboard/tools/delete-tool"},{"openapi":"post /tool/{id}/test","title":"Test tool execution","href":"/api-reference/dashboard/tools/test-tool-execution"}]},{"group":"Sessions","pages":[{"title":"Sessions \u0026 Deployment","description":"Understand sessions and choose how to deploy your agents","href":"/api-reference/dashboard/sessions/overview"},{"openapi":"post /start-agent-session","title":"Start agent session","href":"/api-reference/dashboard/sessions/start-agent-session"}]}]}]},"basePath":"","title":"Test tool execution - iwy.ai Documentation","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}