{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Duckie | Docs","colors":{"primary":"#3d85c6","light":"#ffd966","dark":"#f1c232"},"logo":{"light":"https://mintcdn.com/duckie-27978f8d/dp_7n1W4HjgYseFC/logo/light.svg?fit=max\u0026auto=format\u0026n=dp_7n1W4HjgYseFC\u0026q=85\u0026s=c9febfa4091c8a9fb726ca455e86499a","dark":"https://mintcdn.com/duckie-27978f8d/dp_7n1W4HjgYseFC/logo/dark.svg?fit=max\u0026auto=format\u0026n=dp_7n1W4HjgYseFC\u0026q=85\u0026s=886ae61dbc04c07b4aef0db56784ddc0"},"favicon":"https://mintcdn.com/duckie-27978f8d/kWz01d7vFg8ZzeQb/favicon.svg?fit=max\u0026auto=format\u0026n=kWz01d7vFg8ZzeQb\u0026q=85\u0026s=81c0b17037b139efa9b310000f1cb630","api":{"openapi":{"source":"api-reference/openapi.json","directory":"api-reference"},"url":"full"},"navbar":{"links":[{"href":"https://status.useduckie.ai/","label":"System status"},{"href":"mailto:founders@duckie.ai","label":"Support"}],"primary":{"type":"button","label":"Book a Demo","href":"https://calendly.com/valerie-li-duckie/meet"}},"footer":{"socials":{"x":"https://twitter.com/duckie_ai","linkedin":"https://www.linkedin.com/company/duckie-ai"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://duckie.ai"},{"anchor":"Blog","icon":"newspaper","href":"https://duckie.ai/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"duckie-27978f8d","hasAudioNarration":false,"actualSubdomain":"duckie-27978f8d","customDomains":["docs.duckie.ai"],"gitSource":{"type":"github","owner":"musa-dev-team","repo":"duckie-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aca188199cb97287e4d02ca","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Documentation","count":61},{"language":"default","tag":"Examples","count":39},{"language":"default","tag":"Use Case Blueprints","count":36},{"language":"default","tag":"Integrations","count":25},{"language":"default","tag":"Concepts","count":22},{"language":"default","tag":"API Docs","count":20},{"language":"default","tag":"Building Agents","count":17},{"language":"default","tag":"API Reference","count":13},{"language":"default","tag":"Disputes and Chargebacks","count":11},{"language":"default","tag":"Training Your Agent","count":10}]},"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/tools/retrieve-a-tool","slug":"/api-reference/tools/retrieve-a-tool","pageMetadata":{"openapi":"api-reference/openapi.json GET /api/v1/tools/{tool_id}","title":"Retrieve a tool","description":null,"href":"/api-reference/tools/retrieve-a-tool"},"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":"api-reference/openapi.json GET /api/v1/tools/{tool_id}","title":"Retrieve a tool","description":null,"href":"/api-reference/tools/retrieve-a-tool"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/duckie-27978f8d/7e82c0e780f88f2a/duckie-widget.js"],"openApiReferenceData":{"operation":{"tags":["Tools"],"summary":"Retrieve a tool","operationId":"getTool","parameters":["44706712-e4e9-4d0d-8500-6847bf3da72f"],"responses":{"200":"ddf638bc-ae37-4034-90cc-8b9bcfe1fd4e","400":"70f72028-25c9-418a-a249-53213d00a713","401":"f2ec67f5-fea7-4dc6-a954-dbc06b230e39","403":"7b4cb9c3-94bc-419b-9837-87cd38457b87","404":"8066d3ee-fe75-4a87-968d-65ba4e0053ac","429":"8c65c9d6-ad00-427b-99c6-867a0efc8f3e","500":"04680117-968c-4042-9572-5de75d2a7fea"},"method":"get","type":"path","servers":["e134f423-213d-46fb-846b-2bb91223e4c3"],"security":["ec24a422-a1da-4525-8e48-c69e3a5ace09"],"path":"/api/v1/tools/{tool_id}","baseUrlOptions":["https://app.useduckie.ai"],"title":"Retrieve a tool","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{"44706712-e4e9-4d0d-8500-6847bf3da72f":{"name":"tool_id","in":"path","required":true,"description":"Public tool ID. Duckie and app tools use `duckie:\u003cid>` or `app:\u003cid>`; custom and MCP tools use `custom:\u003cuuid>` or `mcp:\u003cuuid>`.","schema":{"type":"string","isRequired":true,"description":"Public tool ID. Duckie and app tools use `duckie:\u003cid>` or `app:\u003cid>`; custom and MCP tools use `custom:\u003cuuid>` or `mcp:\u003cuuid>`.","uniqueKey":"","typeLabel":"string"}}},"responses":{"ddf638bc-ae37-4034-90cc-8b9bcfe1fd4e":{"description":"Tool.","headers":{"X-RateLimit-Limit":{"description":"Request limit for the active rate-limit bucket.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the active rate-limit bucket.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the active rate-limit bucket resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","object","type","name","description","is_write_action","requires_approval","enabled","parameters","duckie","app","custom","mcp","created_at","updated_at"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"object":{"type":"string","enum":["tool"],"isRequired":true,"uniqueKey":"data.object","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["duckie_tool","app_tool","custom_tool","mcp_tool"],"isRequired":true,"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"data.description","typeLabel":"string"},"is_write_action":{"type":"boolean","isRequired":true,"uniqueKey":"data.is_write_action","typeLabel":"boolean"},"requires_approval":{"type":"boolean","isRequired":true,"uniqueKey":"data.requires_approval","typeLabel":"boolean"},"enabled":{"type":"boolean","isRequired":true,"uniqueKey":"data.enabled","typeLabel":"boolean"},"parameters":{"type":"array","items":{"type":"object","required":["name","type","required","description","has_preset_value"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.parameters.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"data.parameters.items.[INDEX].type","typeLabel":"string"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"data.parameters.items.[INDEX].required","typeLabel":"boolean"},"description":{"type":"string","isRequired":true,"uniqueKey":"data.parameters.items.[INDEX].description","typeLabel":"string"},"has_preset_value":{"type":"boolean","description":"True when the tool parameter has a preset value. The value itself is not exposed.","isRequired":true,"uniqueKey":"data.parameters.items.[INDEX].has_preset_value","typeLabel":"boolean"}},"uniqueKey":"data.parameters.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.parameters","typeLabel":"object[]"},"duckie":{"oneOf":[{"type":"object","properties":{"category":{"oneOf":[{"type":"string","uniqueKey":"data.duckie.oneOf.0.category.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.duckie.oneOf.0.category.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.duckie.oneOf.0.category","typeLabel":"string | null"},"availability":{"oneOf":[{"type":"string","uniqueKey":"data.duckie.oneOf.0.availability.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.duckie.oneOf.0.availability.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.duckie.oneOf.0.availability","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.duckie.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"category":{"oneOf":[{"type":"string"},{"type":"null"}]},"availability":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"data.duckie.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.duckie","typeLabel":"object | null"},"app":{"oneOf":[{"type":"object","properties":{"integration_id":{"type":"string","uniqueKey":"data.app.oneOf.0.integration_id","typeLabel":"string"},"integration_name":{"type":"string","uniqueKey":"data.app.oneOf.0.integration_name","typeLabel":"string"},"connection_mode":{"type":"string","enum":["customer","system"],"uniqueKey":"data.app.oneOf.0.connection_mode","typeLabel":"enum\u003cstring>"},"connection_status":{"type":"string","uniqueKey":"data.app.oneOf.0.connection_status","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.app.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"integration_id":{"type":"string"},"integration_name":{"type":"string"},"connection_mode":{"type":"string","enum":["customer","system"]},"connection_status":{"type":"string"}},"isRequired":true,"uniqueKey":"data.app.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.app","typeLabel":"object | null"},"custom":{"oneOf":[{"type":"object","properties":{"endpoint":{"type":"string","uniqueKey":"data.custom.oneOf.0.endpoint","typeLabel":"string"},"method":{"type":"string","uniqueKey":"data.custom.oneOf.0.method","typeLabel":"string"},"body_format":{"type":"string","uniqueKey":"data.custom.oneOf.0.body_format","typeLabel":"string"},"headers":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.custom.oneOf.0.headers.items.[INDEX].name","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"data.custom.oneOf.0.headers.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"data.custom.oneOf.0.headers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.custom.oneOf.0.headers","typeLabel":"object[]"},"http_timeout_sec":{"oneOf":[{"type":"integer","uniqueKey":"data.custom.oneOf.0.http_timeout_sec.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"data.custom.oneOf.0.http_timeout_sec.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.custom.oneOf.0.http_timeout_sec","typeLabel":"integer | null"},"auth":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"data.custom.oneOf.0.auth.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"data.custom.oneOf.0.auth.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.custom.oneOf.0.auth","typeLabel":"object | null"}},"isRequired":true,"uniqueKey":"data.custom.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"endpoint":{"type":"string"},"method":{"type":"string"},"body_format":{"type":"string"},"headers":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"http_timeout_sec":{"oneOf":[{"type":"integer"},{"type":"null"}]},"auth":{"oneOf":[{"type":"object","additionalProperties":true},{"type":"null","additionalProperties":true}]}},"isRequired":true,"uniqueKey":"data.custom.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.custom","typeLabel":"object | null"},"mcp":{"oneOf":[{"type":"object","properties":{"server_id":{"type":"string","format":"uuid","uniqueKey":"data.mcp.oneOf.0.server_id","typeLabel":"string\u003cuuid>"},"server_name":{"oneOf":[{"type":"string","uniqueKey":"data.mcp.oneOf.0.server_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.mcp.oneOf.0.server_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.mcp.oneOf.0.server_name","typeLabel":"string | null"},"mcp_tool_name":{"type":"string","uniqueKey":"data.mcp.oneOf.0.mcp_tool_name","typeLabel":"string"},"input_schema":{"type":"object","additionalProperties":true,"uniqueKey":"data.mcp.oneOf.0.input_schema","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.mcp.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"server_id":{"type":"string","format":"uuid"},"server_name":{"oneOf":[{"type":"string"},{"type":"null"}]},"mcp_tool_name":{"type":"string"},"input_schema":{"type":"object","additionalProperties":true}},"isRequired":true,"uniqueKey":"data.mcp.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.mcp","typeLabel":"object | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","object":"tool","type":"duckie_tool","name":"\u003cstring>","description":"\u003cstring>","is_write_action":true,"requires_approval":true,"enabled":true,"parameters":[{"name":"\u003cstring>","type":"\u003cstring>","required":true,"description":"\u003cstring>","has_preset_value":true}],"duckie":{"category":"\u003cstring>","availability":"\u003cstring>"},"app":{"integration_id":"\u003cstring>","integration_name":"\u003cstring>","connection_mode":"customer","connection_status":"\u003cstring>"},"custom":{"endpoint":"\u003cstring>","method":"\u003cstring>","body_format":"\u003cstring>","headers":[{"name":"\u003cstring>","value":"\u003cstring>"}],"http_timeout_sec":123,"auth":{}},"mcp":{"server_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","server_name":"\u003cstring>","mcp_tool_name":"\u003cstring>","input_schema":{}},"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"70f72028-25c9-418a-a249-53213d00a713":{"description":"The request was invalid.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","permission_denied","not_found","rate_limited","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retry_after":{"type":"integer","minimum":1,"uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>","retry_after":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"f2ec67f5-fea7-4dc6-a954-dbc06b230e39":{"description":"The request is missing a valid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","permission_denied","not_found","rate_limited","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retry_after":{"type":"integer","minimum":1,"uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>","retry_after":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"7b4cb9c3-94bc-419b-9837-87cd38457b87":{"description":"The API key does not have the required scope.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","permission_denied","not_found","rate_limited","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retry_after":{"type":"integer","minimum":1,"uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>","retry_after":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"8066d3ee-fe75-4a87-968d-65ba4e0053ac":{"description":"The resource was not found in the API key's organization.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","permission_denied","not_found","rate_limited","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retry_after":{"type":"integer","minimum":1,"uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>","retry_after":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"8c65c9d6-ad00-427b-99c6-867a0efc8f3e":{"description":"A rate limit was exceeded.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Limit":{"description":"Request limit for the active rate-limit bucket.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the active rate-limit bucket.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the active rate-limit bucket resets.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","permission_denied","not_found","rate_limited","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retry_after":{"type":"integer","minimum":1,"uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>","retry_after":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"04680117-968c-4042-9572-5de75d2a7fea":{"description":"The API could not complete the request.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","enum":["invalid_request","unauthenticated","permission_denied","not_found","rate_limited","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"retry_after":{"type":"integer","minimum":1,"uniqueKey":"error.retry_after","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>","retry_after":2}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ec24a422-a1da-4525-8e48-c69e3a5ace09":{"DuckieApiKey":{"type":"http","scheme":"bearer","description":"API key created in Duckie Settings -> API Access.","scopes":[]}}},"servers":{"e134f423-213d-46fb-846b-2bb91223e4c3":{"url":"https://app.useduckie.ai","description":"Duckie app"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key created in Duckie Settings -> API Access.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key created in Duckie Settings -> API Access.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"DuckieApiKey","name":"Authorization"}],"title":"DuckieApiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"duckie-27978f8d","siteName":"Duckie | Docs","title":"Retrieve a tool - Duckie | Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-10T10:50:52.342Z","originalFileLocation":"api-reference/tools/retrieve-a-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=\"application-name\" content=\"Duckie | Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/duckie-27978f8d/2LgSLZDNo0t5zyES/_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/duckie-27978f8d/2LgSLZDNo0t5zyES/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/duckie-27978f8d/2LgSLZDNo0t5zyES/_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/duckie-27978f8d/2LgSLZDNo0t5zyES/_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/duckie-27978f8d/2LgSLZDNo0t5zyES/_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/duckie-27978f8d/2LgSLZDNo0t5zyES/_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/duckie-27978f8d/2LgSLZDNo0t5zyES/_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/duckie-27978f8d/2LgSLZDNo0t5zyES/_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/duckie-27978f8d/2LgSLZDNo0t5zyES/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve a tool - Duckie | Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Duckie | Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://duckie-27978f8d.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Retrieve+a+tool\u0026amp;theme=ea74a5b4964b4e0b4db749e8\u0026amp;signature=ac1eae6a2ed7a963bcbe102a9bb15bdc166842cc7af1d664e8b7d61b55a83d7a\">\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=\"Retrieve a tool - Duckie | Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://duckie-27978f8d.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Retrieve+a+tool\u0026amp;theme=ea74a5b4964b4e0b4db749e8\u0026amp;signature=ac1eae6a2ed7a963bcbe102a9bb15bdc166842cc7af1d664e8b7d61b55a83d7a\">\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/duckie-27978f8d/2LgSLZDNo0t5zyES/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Duckie | Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3d85c6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.duckie.ai/api-reference/tools/retrieve-a-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/tools/retrieve-a-tool.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.duckie.ai/#organization\",\"name\":\"Duckie | Docs\",\"url\":\"https://docs.duckie.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/duckie-27978f8d/dp_7n1W4HjgYseFC/logo/light.svg?fit=max\u0026auto=format\u0026n=dp_7n1W4HjgYseFC\u0026q=85\u0026s=c9febfa4091c8a9fb726ca455e86499a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.duckie.ai#website\",\"name\":\"Duckie | Docs\",\"url\":\"https://docs.duckie.ai\",\"publisher\":{\"@id\":\"https://docs.duckie.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool#webpage\",\"url\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool\",\"name\":\"Retrieve a tool\",\"dateModified\":\"2026-10-10T10:50:52.342Z\",\"isPartOf\":{\"@id\":\"https://docs.duckie.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.duckie.ai/api-reference/runs/list-runs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tools\",\"item\":\"https://docs.duckie.ai/api-reference/tools/list-tools\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve a tool\",\"item\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool#apireference\",\"headline\":\"Retrieve a tool\",\"name\":\"Retrieve a tool\",\"url\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool\",\"mainEntityOfPage\":{\"@id\":\"https://docs.duckie.ai/api-reference/tools/retrieve-a-tool#webpage\"},\"dateModified\":\"2026-10-10T10:50:52.342Z\",\"publisher\":{\"@id\":\"https://docs.duckie.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.duckie.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Duckie | Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Duckie | Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/tools/retrieve-a-tool.md","siteName":"Duckie | Docs","nav":{"global":{"anchors":[{"anchor":"Website","icon":"globe","href":"https://duckie.ai"},{"anchor":"Blog","icon":"newspaper","href":"https://duckie.ai/blog"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/overview"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"API Docs","groups":[{"group":"Guides","pages":[{"title":"Duckie API Overview","href":"/api/overview"},{"title":"Authentication","href":"/api/authentication"},{"title":"MCP Endpoint","href":"/api/mcp"},{"title":"Pagination and Filtering","href":"/api/pagination-and-filtering"},{"title":"Rate Limits","href":"/api/rate-limits"},{"title":"Error Responses","href":"/api/errors"},{"title":"API-Key Management","href":"/api/api-key-management"}]},{"group":"API Reference","pages":[{"group":"Runs","pages":[{"openapi":"api-reference/openapi.json GET /api/v1/runs","title":"List runs","href":"/api-reference/runs/list-runs"},{"openapi":"api-reference/openapi.json GET /api/v1/runs/{run_id}","title":"Retrieve a run","href":"/api-reference/runs/retrieve-a-run"},{"openapi":"api-reference/openapi.json GET /api/v1/runs/tool-options","title":"List run tool filter options","href":"/api-reference/runs/list-run-tool-filter-options"}]},{"group":"Tools","pages":[{"openapi":"api-reference/openapi.json GET /api/v1/tools","title":"List tools","description":"Returns the organization's tool catalog, including Duckie tools, app tools, custom tools, and MCP tools.","href":"/api-reference/tools/list-tools"},{"openapi":"api-reference/openapi.json GET /api/v1/tools/{tool_id}","title":"Retrieve a tool","href":"/api-reference/tools/retrieve-a-tool"}]},{"group":"Agents","pages":[{"openapi":"api-reference/openapi.json GET /api/v1/agents","title":"List agents","description":null,"href":"/api-reference/agents/list-agents"},{"openapi":"api-reference/openapi.json GET /api/v1/agents/{agent_id}","title":"Retrieve an agent","href":"/api-reference/agents/retrieve-an-agent"}]},{"group":"Guidelines","pages":[{"openapi":"api-reference/openapi.json GET /api/v1/guidelines","title":"List guidelines","href":"/api-reference/guidelines/list-guidelines"},{"openapi":"api-reference/openapi.json GET /api/v1/guidelines/{guideline_id}","title":"Retrieve a guideline","href":"/api-reference/guidelines/retrieve-a-guideline"}]},{"group":"Guardrails","pages":[{"openapi":"api-reference/openapi.json GET /api/v1/guardrails","title":"List guardrails","href":"/api-reference/guardrails/list-guardrails"},{"openapi":"api-reference/openapi.json GET /api/v1/guardrails/{guardrail_id}","title":"Retrieve a guardrail","href":"/api-reference/guardrails/retrieve-a-guardrail"}]},{"group":"Runbooks","pages":[{"openapi":"api-reference/openapi.json GET /api/v1/runbooks","title":"List runbooks","href":"/api-reference/runbooks/list-runbooks"},{"openapi":"api-reference/openapi.json GET /api/v1/runbooks/{runbook_id}","title":"Retrieve a runbook","href":"/api-reference/runbooks/retrieve-a-runbook"}]}]}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/overview"}]}]},"basePath":"","title":"Retrieve a tool - Duckie | Docs","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}