import Riza from '@riza-io/api';const client = new Riza({ apiKey: process.env['RIZA_API_KEY'], // This is the default and can be omitted});const response = await client.tools.exec('id');console.log(response.execution);
import os
from rizaio import Riza
client = Riza(
api_key=os.environ.get("RIZA_API_KEY"), # This is the default and can be omitted
)
response = client.tools.exec(
id="id",
)
print(response.execution)
Execute a tool with a given input. The input is validated against the tool’s input schema.
JavaScript
import Riza from '@riza-io/api';const client = new Riza({ apiKey: process.env['RIZA_API_KEY'], // This is the default and can be omitted});const response = await client.tools.exec('id');console.log(response.execution);
import os
from rizaio import Riza
client = Riza(
api_key=os.environ.get("RIZA_API_KEY"), # This is the default and can be omitted
)
response = client.tools.exec(
id="id",
)
print(response.execution)
The Tool revision ID to execute. This optional parmeter is used to pin executions to specific versions of the Tool. If not provided, the latest (current) version of the Tool will be executed.
The status of the output. "valid" means your Tool executed successfully and returned a valid JSON-serializable object, or void. "json_serialization_error" means your Tool executed successfully, but returned a nonserializable object. "error" means your Tool failed to execute.
Available options:
error,
json_serialization_error,
valid
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Riza","colors":{"primary":"#6D3E1C","light":"#F3E6CD","dark":"#150F0A"},"logo":{"light":"https://mintcdn.com/rizainc/pI0gH_-ICv-ySWJQ/logo/light.svg?fit=max\u0026auto=format\u0026n=pI0gH_-ICv-ySWJQ\u0026q=85\u0026s=0d9bef6436745a02be344f01336ff72f","dark":"https://mintcdn.com/rizainc/pI0gH_-ICv-ySWJQ/logo/dark.svg?fit=max\u0026auto=format\u0026n=pI0gH_-ICv-ySWJQ\u0026q=85\u0026s=1e1a571121f08f276200373379438d4f"},"favicon":"/favicon.png","api":{"openapi":["openapi.enhanced.yaml"],"playground":{"display":"none"}},"navbar":{"links":[{"label":"Website","href":"https://riza.io/"},{"label":"Email us","href":"mailto:hello@riza.io"},{"label":"Discord","href":"https://discord.gg/4P6PUeJFW5"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.riza.io/"}},"footer":{"socials":{"website":"https://riza.io","x":"https://x.com/rizaio","bluesky":"https://bsky.app/profile/riza.io","discord":"https://discord.gg/4P6PUeJFW5","github":"https://github.com/riza-io","linkedin":"https://www.linkedin.com/company/riza-inc","youtube":"https://www.youtube.com/@Riza-Inc"}},"integrations":{"plausible":{"domain":"riza.io"}},"banner":{"content":"The Code Interpreter API is shutting down on October 1st, 2025. Read more [here](https://riza.io/blog/shutting-down-hosted-code-interpreter)."},"navigation":{"global":{"anchors":[{"anchor":"Try the API playground","icon":"circle-play","href":"https://riza.io/playground"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rizainc","hasAudioNarration":false,"actualSubdomain":"rizainc","customDomains":["docs.riza.io"],"gitSource":{"type":"github","owner":"riza-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae91fb349359631f6861aaf:success","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":35},{"language":"default","tag":"API Reference","count":19},{"language":"default","tag":"Custom Runtimes","count":7},{"language":"default","tag":"Code Execution","count":7},{"language":"default","tag":"Tools","count":5},{"language":"default","tag":"Tool-use Guides","count":5},{"language":"default","tag":"Interpreter Environment","count":5},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Use Case Guides","count":4},{"language":"default","tag":"I/O Reference","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tool/execute-tool","slug":"/api-reference/tool/execute-tool","pageMetadata":{"openapi":"post /v1/tools/{id}/execute","title":"Execute tool","description":"Execute a tool with a given input. The input is validated against the tool's input schema.","href":"/api-reference/tool/execute-tool"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Execute a tool with a given input. The input is validated against the tool’s input schema.\"\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":{"config":{},"pageMetadata":{"openapi":"post /v1/tools/{id}/execute","title":"Execute tool","description":"Execute a tool with a given input. The input is validated against the tool's input schema.","href":"/api-reference/tool/execute-tool"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Execute a tool with a given input. The input is validated against the tool's input schema.","operationId":"executeTool","parameters":["5f4b10f6-f06a-4552-831f-6c628ebfcd3e"],"requestBody":"9515f1be-952f-4da5-b2ac-48e8ef64de96","responses":{"200":"ae96da5e-262c-4fc8-9f7a-7a97a68d7adb","401":"9958c44c-1708-414b-b7d6-89131bd4be13"},"summary":"Execute tool","tags":["Tool"],"x-codeSamples":[{"lang":"JavaScript","source":"import Riza from '@riza-io/api';\n\nconst client = new Riza({\n apiKey: process.env['RIZA_API_KEY'], // This is the default and can be omitted\n});\n\nconst response = await client.tools.exec('id');\n\nconsole.log(response.execution);"},{"lang":"Python","source":"import os\nfrom rizaio import Riza\n\nclient = Riza(\n api_key=os.environ.get(\"RIZA_API_KEY\"), # This is the default and can be omitted\n)\nresponse = client.tools.exec(\n id=\"id\",\n)\nprint(response.execution)"},{"lang":"Go","source":"package main\n\nimport (\n \"context\"\n \"fmt\"\n\n \"github.com/riza-io/riza-api-go\"\n \"github.com/riza-io/riza-api-go/option\"\n)\n\nfunc main() {\n client := riza.NewClient(\n option.WithAPIKey(\"My API Key\"), // defaults to os.LookupEnv(\"RIZA_API_KEY\")\n )\n response, err := client.Tools.Exec(\n context.TODO(),\n \"id\",\n riza.ToolExecParams{\n\n },\n )\n if err != nil {\n panic(err.Error())\n }\n fmt.Printf(\"%+v\\n\", response.Execution)\n}\n"}],"method":"post","type":"path","servers":["d0941187-539b-4ea1-b339-3391ad343706"],"security":["dab6cadc-4d66-4870-b4fa-49b27d6a3e15"],"path":"/v1/tools/{id}/execute","baseUrlOptions":["https://api.riza.io"],"title":"Execute tool","codeSamples":[{"lang":"JavaScript","source":"import Riza from '@riza-io/api';\n\nconst client = new Riza({\n apiKey: process.env['RIZA_API_KEY'], // This is the default and can be omitted\n});\n\nconst response = await client.tools.exec('id');\n\nconsole.log(response.execution);"},{"lang":"Python","source":"import os\nfrom rizaio import Riza\n\nclient = Riza(\n api_key=os.environ.get(\"RIZA_API_KEY\"), # This is the default and can be omitted\n)\nresponse = client.tools.exec(\n id=\"id\",\n)\nprint(response.execution)"},{"lang":"Go","source":"package main\n\nimport (\n \"context\"\n \"fmt\"\n\n \"github.com/riza-io/riza-api-go\"\n \"github.com/riza-io/riza-api-go/option\"\n)\n\nfunc main() {\n client := riza.NewClient(\n option.WithAPIKey(\"My API Key\"), // defaults to os.LookupEnv(\"RIZA_API_KEY\")\n )\n response, err := client.Tools.Exec(\n context.TODO(),\n \"id\",\n riza.ToolExecParams{\n\n },\n )\n if err != nil {\n panic(err.Error())\n }\n fmt.Printf(\"%+v\\n\", response.Execution)\n}\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"5f4b10f6-f06a-4552-831f-6c628ebfcd3e":{"in":"path","name":"id","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"properties":{"env":{"description":"Set of key-value pairs to add to the tool's execution environment.","items":{"description":"Set of key-value pairs to add to the tool's execution environment.","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"env.items.[INDEX].name","typeLabel":"string"},"secret_id":{"type":"string","uniqueKey":"env.items.[INDEX].secret_id","typeLabel":"string"},"value":{"type":"string","uniqueKey":"env.items.[INDEX].value","typeLabel":"string"}},"required":["name"],"type":"object","uniqueKey":"env.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"env","typeLabel":"object[]"},"http":{"description":"Configuration for HTTP requests and authentication.","properties":{"allow":{"description":"List of allowed HTTP hosts and associated authentication.","items":{"description":"List of allowed HTTP hosts and associated authentication.","properties":{"auth":{"description":"Authentication configuration for outbound requests to this host.","properties":{"basic":{"properties":{"password":{"type":"string","uniqueKey":"http.allow.items.[INDEX].auth.basic.password","typeLabel":"string"},"secret_id":{"type":"string","uniqueKey":"http.allow.items.[INDEX].auth.basic.secret_id","typeLabel":"string"},"user_id":{"type":"string","uniqueKey":"http.allow.items.[INDEX].auth.basic.user_id","typeLabel":"string"}},"type":"object","uniqueKey":"http.allow.items.[INDEX].auth.basic","typeLabel":"object"},"bearer":{"description":"Configuration to add an 'Authorization' header using the 'Bearer' scheme.","properties":{"secret_id":{"type":"string","uniqueKey":"http.allow.items.[INDEX].auth.bearer.secret_id","typeLabel":"string"},"token":{"description":"The token to set, e.g. 'Authorization: Bearer \u003ctoken>'.","type":"string","uniqueKey":"http.allow.items.[INDEX].auth.bearer.token","typeLabel":"string"}},"type":"object","uniqueKey":"http.allow.items.[INDEX].auth.bearer","typeLabel":"object"},"query":{"properties":{"key":{"type":"string","uniqueKey":"http.allow.items.[INDEX].auth.query.key","typeLabel":"string"},"secret_id":{"type":"string","uniqueKey":"http.allow.items.[INDEX].auth.query.secret_id","typeLabel":"string"},"value":{"type":"string","uniqueKey":"http.allow.items.[INDEX].auth.query.value","typeLabel":"string"}},"type":"object","uniqueKey":"http.allow.items.[INDEX].auth.query","typeLabel":"object"}},"type":"object","uniqueKey":"http.allow.items.[INDEX].auth","typeLabel":"object"},"host":{"description":"The hostname to allow.","type":"string","uniqueKey":"http.allow.items.[INDEX].host","typeLabel":"string"}},"type":"object","uniqueKey":"http.allow.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"http.allow","typeLabel":"object[]"}},"type":"object","uniqueKey":"http","typeLabel":"object"},"input":{"description":"The input to the tool. This must be a valid JSON-serializable object. It will be validated against the tool's input schema.","uniqueKey":"input","typeLabel":"any"},"revision_id":{"description":"The Tool revision ID to execute. This optional parmeter is used to pin executions to specific versions of the Tool. If not provided, the latest (current) version of the Tool will be executed.","type":"string","uniqueKey":"revision_id","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"env":[{"name":"\u003cstring>","secret_id":"\u003cstring>","value":"\u003cstring>"}],"http":{"allow":[{"auth":{"basic":{"password":"\u003cstring>","secret_id":"\u003cstring>","user_id":"\u003cstring>"},"bearer":{"secret_id":"\u003cstring>","token":"\u003cstring>"},"query":{"key":"\u003cstring>","secret_id":"\u003cstring>","value":"\u003cstring>"}},"host":"\u003cstring>"}]},"input":"\u003cunknown>","revision_id":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"ae96da5e-262c-4fc8-9f7a-7a97a68d7adb":{"content":{"application/json":{"schema":{"properties":{"execution":{"description":"The execution details of the function.","properties":{"duration":{"description":"The execution time of the function in milliseconds.","type":"integer","isRequired":true,"uniqueKey":"execution.duration","typeLabel":"integer"},"exit_code":{"description":"The exit code returned by the function. Will often be '0' on success and non-zero on failure.","type":"integer","isRequired":true,"uniqueKey":"execution.exit_code","typeLabel":"integer"},"id":{"description":"The ID of the execution.","type":"string","isRequired":true,"uniqueKey":"execution.id","typeLabel":"string"},"stderr":{"description":"The contents of 'stderr' after executing the function.","type":"string","isRequired":true,"uniqueKey":"execution.stderr","typeLabel":"string"},"stdout":{"description":"The contents of 'stdout' after executing the function.","type":"string","isRequired":true,"uniqueKey":"execution.stdout","typeLabel":"string"}},"required":["id","exit_code","stdout","stderr","duration"],"type":"object","isRequired":true,"uniqueKey":"execution","typeLabel":"object"},"output":{"description":"The returned value of the Tool's execute function.","isRequired":true,"uniqueKey":"output","typeLabel":"any"},"output_status":{"description":"The status of the output. \"valid\" means your Tool executed successfully and returned a valid JSON-serializable object, or void. \"json_serialization_error\" means your Tool executed successfully, but returned a nonserializable object. \"error\" means your Tool failed to execute.","enum":["error","json_serialization_error","valid"],"type":"string","isRequired":true,"uniqueKey":"output_status","typeLabel":"enum\u003cstring>"}},"required":["output","output_status","execution"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"execution":{"duration":123,"exit_code":123,"id":"\u003cstring>","stderr":"\u003cstring>","stdout":"\u003cstring>"},"output":"\u003cunknown>","output_status":"error"}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"9958c44c-1708-414b-b7d6-89131bd4be13":{"content":{"application/json":{"examples":{"unauthenticated":{"title":"unauthenticated","value":{"code":16,"message":"unauthenticated"}}},"schema":{"properties":{"code":{"description":"The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].","type":"integer","uniqueKey":"code","typeLabel":"integer"},"message":{"description":"A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.","type":"string","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Unauthenticated error response","exampleType":"examples"}},"security":{"dab6cadc-4d66-4870-b4fa-49b27d6a3e15":{"bearerHttpAuthentication":{"scheme":"bearer","type":"http","scopes":[]}}},"servers":{"d0941187-539b-4ea1-b339-3391ad343706":{"url":"https://api.riza.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerHttpAuthentication","name":"Authorization"}],"title":"bearerHttpAuthentication"}]},"originalFileLocation":"openapi.enhanced.yaml"},"subdomain":"rizainc","siteName":"Riza","title":"Execute tool - Riza","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T01:48:41.221Z","originalFileLocation":"api-reference/tool/execute-tool.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=\"Execute a tool with a given input. The input is validated against the tool\u0026#x27;s input schema.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Riza\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rizainc/DnTJkfgCNEmMOTTW/_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/rizainc/DnTJkfgCNEmMOTTW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rizainc/DnTJkfgCNEmMOTTW/_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/rizainc/DnTJkfgCNEmMOTTW/_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/rizainc/DnTJkfgCNEmMOTTW/_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/rizainc/DnTJkfgCNEmMOTTW/_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/rizainc/DnTJkfgCNEmMOTTW/_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/rizainc/DnTJkfgCNEmMOTTW/_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/rizainc/DnTJkfgCNEmMOTTW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Execute tool - Riza\">\u003cmeta data-mint-head property=\"og:description\" content=\"Execute a tool with a given input. The input is validated against the tool\u0026#x27;s input schema.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Riza\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.riza.io/api-reference/tool/execute-tool\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rizainc.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Execute+tool\u0026amp;description=Execute+a+tool+with+a+given+input.+The+input+is+validated+against+the+tool%27s+input+schema.\u0026amp;theme=6e1e032617fed851d30276df\u0026amp;signature=9b5af212e80cfe3c3ea90b6a9f98ee00d14d99c1f0dc1b1812afeb4666cb44e2\">\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=\"Execute tool - Riza\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Execute a tool with a given input. The input is validated against the tool\u0026#x27;s input schema.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rizainc.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Execute+tool\u0026amp;description=Execute+a+tool+with+a+given+input.+The+input+is+validated+against+the+tool%27s+input+schema.\u0026amp;theme=6e1e032617fed851d30276df\u0026amp;signature=9b5af212e80cfe3c3ea90b6a9f98ee00d14d99c1f0dc1b1812afeb4666cb44e2\">\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/rizainc/DnTJkfgCNEmMOTTW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Riza\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6D3E1C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.riza.io/api-reference/tool/execute-tool\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tool/execute-tool.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.riza.io/#organization\",\"name\":\"Riza\",\"url\":\"https://docs.riza.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rizainc/pI0gH_-ICv-ySWJQ/logo/light.svg?fit=max\u0026auto=format\u0026n=pI0gH_-ICv-ySWJQ\u0026q=85\u0026s=0d9bef6436745a02be344f01336ff72f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.riza.io#website\",\"name\":\"Riza\",\"url\":\"https://docs.riza.io\",\"publisher\":{\"@id\":\"https://docs.riza.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.riza.io/api-reference/tool/execute-tool#webpage\",\"url\":\"https://docs.riza.io/api-reference/tool/execute-tool\",\"name\":\"Execute tool\",\"description\":\"Execute a tool with a given input. The input is validated against the tool's input schema.\",\"dateModified\":\"2026-01-07T01:48:41.221Z\",\"isPartOf\":{\"@id\":\"https://docs.riza.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.riza.io/api-reference/tool/execute-tool#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.riza.io/api-reference/tool/execute-tool#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://docs.riza.io/api-reference/tool/list-tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Execute tool\",\"item\":\"https://docs.riza.io/api-reference/tool/execute-tool\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.riza.io/api-reference/tool/execute-tool#apireference\",\"headline\":\"Execute tool\",\"name\":\"Execute tool\",\"description\":\"Execute a tool with a given input. The input is validated against the tool's input schema.\",\"url\":\"https://docs.riza.io/api-reference/tool/execute-tool\",\"mainEntityOfPage\":{\"@id\":\"https://docs.riza.io/api-reference/tool/execute-tool#webpage\"},\"dateModified\":\"2026-01-07T01:48:41.221Z\",\"publisher\":{\"@id\":\"https://docs.riza.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.riza.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Riza\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Riza\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/tool/execute-tool.md","siteName":"Riza","nav":{"global":{"anchors":[{"anchor":"Try the API playground","icon":"circle-play","href":"https://riza.io/playground"}]},"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/introduction"}]},{"tab":"Self-hosting","icon":"server","pages":[{"title":"Self-hosting","href":"/self-hosting/quickstart"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"Introduction","icon":"megaphone","href":"/api-reference/introduction"}]},{"group":"Code","pages":[{"openapi":"post /v1/execute","title":"Execute code","href":"/api-reference/command/execute-code"},{"openapi":"post /v1/execute-function","title":"Execute function","href":"/api-reference/command/execute-function"}]},{"group":"Custom Runtimes","pages":[{"openapi":"get /v1/runtimes","title":"List runtimes","href":"/api-reference/runtime/list-runtimes"},{"openapi":"post /v1/runtimes","title":"Create runtime","href":"/api-reference/runtime/create-runtime"},{"openapi":"get /v1/runtimes/{id}","title":"Retrieve runtime","href":"/api-reference/runtime/retrieve-runtime"},{"openapi":"delete /v1/runtimes/{id}","title":"Delete a runtime","href":"/api-reference/runtime/delete-a-runtime"},{"openapi":"get /v1/runtimes/{id}/revisions","title":"List runtime revisions","href":"/api-reference/runtime/list-runtime-revisions"},{"openapi":"post /v1/runtimes/{id}/revisions","title":"Create runtime revision","href":"/api-reference/runtime/create-runtime-revision"},{"openapi":"get /v1/runtimes/{runtime_id}/revisions/{revision_id}","title":"Retrieve runtime revision","href":"/api-reference/runtime/retrieve-runtime-revision"}]},{"group":"Secrets","pages":[{"openapi":"get /v1/secrets","title":"List secrets","href":"/api-reference/secret/list-secrets"},{"openapi":"post /v1/secrets","title":"Create secret","href":"/api-reference/secret/create-secret"}]},{"group":"Tools","pages":[{"openapi":"get /v1/tools","title":"List tools","href":"/api-reference/tool/list-tools"},{"openapi":"post /v1/tools","title":"Create tool","href":"/api-reference/tool/create-tool"},{"openapi":"get /v1/tools/{id}","title":"Retrieve tool","href":"/api-reference/tool/retrieve-tool"},{"openapi":"post /v1/tools/{id}","title":"Modify tool","description":"Update the source code and input schema of a tool.","href":"/api-reference/tool/modify-tool"},{"openapi":"post /v1/tools/{id}/execute","title":"Execute tool","href":"/api-reference/tool/execute-tool"}]},{"group":"Execution","pages":[{"openapi":"get /v1/executions","title":"List executions","description":"Returns a list of executions in your project.","href":"/api-reference/execution/list-executions"},{"openapi":"get /v1/executions/{id}","title":"Retrieve execution","href":"/api-reference/execution/retrieve-execution"}]}]}]},"basePath":"","title":"Execute tool - Riza","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DV3Oq1fY.js","dist-C-XZBk9h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-D3Isdib3.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","AssistantPageLink--qIqmmVG.js"]}