{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fetch Hive","colors":{"primary":"#f97316","light":"#facc15","dark":"#f97316"},"logo":{"light":"https://assets.fetchhive.com/fetchhive_logo_v3.png","dark":"https://assets.fetchhive.com/fetchhive_logo_v3_white_v4.png"},"favicon":"https://framerusercontent.com/images/Oy1cgYdMfZwS6IB2gUbA8JGevI.png","navbar":{"links":[{"href":"mailto:tom@fetchhive.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.fetchhive.com"}},"footer":{"socials":{"x":"https://x.com/fetchhive","linkedin":"https://www.linkedin.com/company/fetchhive","youtube":"https://www.youtube.com/@fetchhive/videos","discord":"https://discord.com/invite/WGPvnTkRwz"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"getting-started/overview"},{"language":"zh","href":"zh/getting-started/overview"},{"language":"es","href":"es/getting-started/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fetchhive-e55daee4","hasAudioNarration":false,"actualSubdomain":"fetchhive-e55daee4","customDomains":["docs.fetchhive.com"],"gitSource":{"type":"github","owner":"jellyfishboy","repo":"fetchhive-api","deployBranch":"master","contentDirectory":"LIVE_DOCS","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af3c941ac217235f731424f","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"en","tag":"Docs","count":272},{"language":"es","tag":"Docs","count":267},{"language":"zh","tag":"文档","count":267},{"language":"en","tag":"Workflows","count":114},{"language":"es","tag":"Flujos de trabajo","count":113},{"language":"zh","tag":"工作流","count":113},{"language":"en","tag":"Workflow Steps","count":99},{"language":"es","tag":"Pasos del flujo de trabajo","count":98},{"language":"zh","tag":"工作流步骤","count":98},{"language":"en","tag":"Agents","count":89},{"language":"es","tag":"Agentes","count":89},{"language":"zh","tag":"智能体","count":89},{"language":"en","tag":"MCP Tools","count":74},{"language":"es","tag":"Herramientas MCP","count":74},{"language":"zh","tag":"MCP 工具","count":74},{"language":"en","tag":"Integrations","count":60},{"language":"es","tag":"Integraciones","count":60},{"language":"zh","tag":"集成","count":60},{"language":"default","tag":"API Reference","count":24},{"language":"default","tag":"REST API","count":24},{"language":"en","tag":"Web Research","count":21},{"language":"es","tag":"Investigación web","count":21},{"language":"zh","tag":"网络研究","count":21},{"language":"en","tag":"Hive Agents","count":15},{"language":"en","tag":"Your Workspace","count":15},{"language":"es","tag":"Tu espacio de trabajo","count":15},{"language":"zh","tag":"您的工作区","count":15},{"language":"es","tag":"Hive Agents","count":11},{"language":"zh","tag":"Hive Agents","count":11},{"language":"default","tag":"Agents","count":11},{"language":"en","tag":"API Reference","count":10},{"language":"es","tag":"Referencia de la API","count":10},{"language":"zh","tag":"API 参考","count":10},{"language":"default","tag":"Knowledge Bases","count":7},{"language":"default","tag":"Assets","count":2},{"language":"default","tag":"Search Services","count":2},{"language":"default","tag":"Models","count":1},{"language":"default","tag":"Requests","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"tom@fetchhive.com","showHelpButton":true}},"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/agents/create-an-agent","slug":"/api-reference/agents/create-an-agent","pageMetadata":{"title":"Create an agent","description":"Creates a new agent in the requested workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/create-an-agent","autogeneratedByOpenApi":true},"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: \"Creates a new agent in the requested workspace.\"\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":{"title":"Create an agent","description":"Creates a new agent in the requested workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/create-an-agent","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create an agent","tags":["Agents"],"security":["75d45b77-e3cb-456c-bf33-34786de1bb34"],"description":"Creates a new agent in the requested workspace.","parameters":[],"responses":{"200":"d084f84a-b11f-41d4-88f1-53b97f32b8d7","401":"6e1a5835-7caa-4637-9124-8c787d3e5c34","422":"6ee9c280-64cb-45bb-9d9d-997d346bec79"},"requestBody":"a46f694b-fb86-44dd-862b-c6490ac120bb","method":"post","type":"path","servers":["c537e6f8-f3ff-4263-8575-92e91378f329"],"path":"/v1/public/workspaces/{workspace_id}/agents","baseUrlOptions":["https://api.fetchhive.com"],"title":"Create an agent","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ad7b1ce2-705f-4bf4-aa04-42677479e4cd":{"name":"workspace_id","in":"path","required":true,"description":"Workspace UUID","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Workspace UUID","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"type":"object","properties":{"name":{"type":"string","example":"My Agent","isRequired":true,"uniqueKey":"agent.name","typeLabel":"string"},"llm_model":{"type":"string","example":"gpt-4.1-mini","isRequired":true,"uniqueKey":"agent.llm_model","typeLabel":"string"},"model_type":{"type":"string","example":"hosted","isRequired":true,"uniqueKey":"agent.model_type","typeLabel":"string"},"description":{"type":"string","example":"A helpful assistant","uniqueKey":"agent.description","typeLabel":"string"},"instruction_prompt":{"type":"string","example":"You are a helpful assistant","uniqueKey":"agent.instruction_prompt","typeLabel":"string"},"temperature":{"type":"number","example":0.7,"uniqueKey":"agent.temperature","typeLabel":"number"},"max_token":{"type":"string","format":"uuid","uniqueKey":"agent.max_token","typeLabel":"string\u003cuuid>"}},"required":["name","llm_model","model_type"],"isRequired":true,"uniqueKey":"agent","typeLabel":"object"}},"required":["agent"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agent":{"name":"My Agent","llm_model":"gpt-4.1-mini","model_type":"hosted","description":"A helpful assistant","instruction_prompt":"You are a helpful assistant","temperature":0.7,"max_token":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"d084f84a-b11f-41d4-88f1-53b97f32b8d7":{"description":"agent created","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Successfully created an agent.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"agent":{"type":"object","isRequired":true,"uniqueKey":"agent","typeLabel":"object"}},"required":["message","agent"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Successfully created an agent.","agent":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"6e1a5835-7caa-4637-9124-8c787d3e5c34":{"description":"unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Invalid access.","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid access."}}},"exampleType":"generated"}},"exampleType":"generated"},"6ee9c280-64cb-45bb-9d9d-997d346bec79":{"description":"invalid LLM model","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"75d45b77-e3cb-456c-bf33-34786de1bb34":{"bearer_auth":{"type":"http","scheme":"bearer","description":"Workspace API key sent as `Authorization: Bearer \u003capi_key>`.","scopes":[],"schemeName":"bearer_auth"}}},"servers":{"c537e6f8-f3ff-4263-8575-92e91378f329":{"url":"https://api.fetchhive.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Workspace API key sent as `Authorization: Bearer \u003capi_key>`.","scopes":[],"schemeName":"bearer_auth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace API key sent as `Authorization: Bearer \u003capi_key>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer_auth","name":"Authorization"}],"title":"bearer_auth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"fetchhive-e55daee4","siteName":"Fetch Hive","title":"Create an agent - Fetch Hive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/agents/create-an-agent","matchLevel":0},"zh":{"href":"/api-reference/agents/create-an-agent","matchLevel":0},"es":{"href":"/api-reference/agents/create-an-agent","matchLevel":0}}},"lastModified":"2026-10-09T09:08:06.168Z","originalFileLocation":"api-reference/agents/create-an-agent.mdx","locale":"en"},"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=\"Creates a new agent in the requested workspace.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fetch Hive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://framerusercontent.com/images/Oy1cgYdMfZwS6IB2gUbA8JGevI.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://framerusercontent.com/images/Oy1cgYdMfZwS6IB2gUbA8JGevI.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://framerusercontent.com/images/Oy1cgYdMfZwS6IB2gUbA8JGevI.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://framerusercontent.com/images/Oy1cgYdMfZwS6IB2gUbA8JGevI.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an agent - Fetch Hive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new agent in the requested workspace.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fetch Hive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fetchhive.com/api-reference/agents/create-an-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fetchhive-e55daee4.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+an+agent\u0026amp;description=Creates+a+new+agent+in+the+requested+workspace.\u0026amp;theme=9af6bc674466eeea378bbb25\u0026amp;signature=e4daee0ec45f3cd6a44eac77f9724780bce3d1b32d33d05633fb5a83560e0f87\">\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=\"Create an agent - Fetch Hive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new agent in the requested workspace.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fetchhive-e55daee4.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+an+agent\u0026amp;description=Creates+a+new+agent+in+the+requested+workspace.\u0026amp;theme=9af6bc674466eeea378bbb25\u0026amp;signature=e4daee0ec45f3cd6a44eac77f9724780bce3d1b32d33d05633fb5a83560e0f87\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/fetchhive-e55daee4/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fetch Hive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#f97316\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fetchhive.com/api-reference/agents/create-an-agent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agents/create-an-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fetchhive.com/#organization\",\"name\":\"Fetch Hive\",\"url\":\"https://docs.fetchhive.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://assets.fetchhive.com/fetchhive_logo_v3.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fetchhive.com#website\",\"name\":\"Fetch Hive\",\"url\":\"https://docs.fetchhive.com\",\"publisher\":{\"@id\":\"https://docs.fetchhive.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent#webpage\",\"url\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent\",\"name\":\"Create an agent\",\"description\":\"Creates a new agent in the requested workspace.\",\"dateModified\":\"2026-10-09T09:08:06.168Z\",\"isPartOf\":{\"@id\":\"https://docs.fetchhive.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.fetchhive.com/api-reference/prompts/invoke\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.fetchhive.com/api-reference/agents/invoke\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create an agent\",\"item\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent#apireference\",\"headline\":\"Create an agent\",\"name\":\"Create an agent\",\"description\":\"Creates a new agent in the requested workspace.\",\"url\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fetchhive.com/api-reference/agents/create-an-agent#webpage\"},\"dateModified\":\"2026-10-09T09:08:06.168Z\",\"publisher\":{\"@id\":\"https://docs.fetchhive.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fetchhive.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fetch Hive\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Fetch Hive\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agents/create-an-agent.md","siteName":"Fetch Hive","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/getting-started/overview"}]},{"tab":"API Reference","groups":[{"group":"Fetch Hive API","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors and rate limits","href":"/api-reference/errors-and-rate-limits"},{"title":"Error codes","href":"/api-reference/error-codes"},{"title":"OpenAPI Spec","href":"/api-reference/openapi-spec"}]},{"group":"REST API","pages":[{"group":"Prompts","pages":[{"title":"Invoke","href":"/api-reference/prompts/invoke"}]},{"group":"Workflows","pages":[{"title":"Invoke","href":"/api-reference/workflows/invoke"}]},{"group":"Agents","pages":[{"title":"Invoke","href":"/api-reference/agents/invoke"},{"title":"Tool approvals","href":"/api-reference/agents/tool-approvals"},{"title":"List tool action approvals","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/tool_action_approvals","href":"/api-reference/tool-action-approvals/list-tool-action-approvals"},{"title":"Show a tool action approval","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/tool_action_approvals/{id}","href":"/api-reference/tool-action-approvals/show-a-tool-action-approval"},{"title":"Decide a tool action approval","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/tool_action_approvals/{id}/decide","href":"/api-reference/tool-action-approvals/decide-a-tool-action-approval"},{"title":"Get an agent delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/agent/delegations/{id}","href":"/api-reference/agents/get-an-agent-delegation"},{"title":"Cancel an agent delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/agent/delegations/{id}/cancel","href":"/api-reference/agents/cancel-an-agent-delegation"},{"title":"List pending agent delegations for a thread","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/agent/threads/{thread_id}/delegations","href":"/api-reference/agents/list-pending-agent-delegations-for-a-thread"},{"title":"List public workspace agents","description":"Returns standalone agents scoped to the requested public API workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/list-public-workspace-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","description":"Returns a single active agent belonging to the requested workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/update-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/delete-an-agent"}]},{"group":"Hive Agents","pages":[{"title":"Invoke","href":"/api-reference/hive-agents/invoke"}]},{"group":"Knowledge Bases","pages":[{"title":"List public workspace knowledge bases","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases","href":"/api-reference/knowledge-bases/list-public-workspace-knowledge-bases"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/knowledge_bases","href":"/api-reference/knowledge-bases/create-a-knowledge-base"},{"title":"Get a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/get-a-knowledge-base"},{"title":"Update a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/update-a-knowledge-base"},{"title":"Delete a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/delete-a-knowledge-base"},{"title":"List public workspace knowledge base items","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}/items","href":"/api-reference/knowledge-base-items/list-public-workspace-knowledge-base-items"},{"title":"Search a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}/search","href":"/api-reference/knowledge-bases/search-a-knowledge-base"}]},{"group":"Assets","pages":[{"title":"List public workspace assets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/assets","href":"/api-reference/assets/list-public-workspace-assets"},{"title":"Upload a public workspace asset","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/assets","href":"/api-reference/assets/upload-a-public-workspace-asset"}]},{"group":"Models","pages":[{"title":"List active models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/models","href":"/api-reference/models/list-active-models"}]},{"group":"Requests","pages":[{"title":"Get a request","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/requests/{id}","href":"/api-reference/requests/get-a-request"}]},{"group":"Search Services","pages":[{"title":"List public search-service country catalogs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/search_services/countries","href":"/api-reference/search-services/list-public-search-service-country-catalogs"},{"title":"Retrieve public search-service country catalog","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/search_services/{service}/countries","href":"/api-reference/search-services/retrieve-public-search-service-country-catalog"}]}]}]}]},{"language":"zh","tabs":[{"tab":"文档","pages":[{"title":"文档","href":"/zh/getting-started/overview"}]},{"tab":"API 参考","groups":[{"group":"Fetch Hive API","pages":[{"title":"概述","href":"/zh/api-reference/overview"},{"title":"身份验证","href":"/zh/api-reference/authentication"},{"title":"错误和速率限制","href":"/zh/api-reference/errors-and-rate-limits"},{"title":"错误代码","href":"/zh/api-reference/error-codes"},{"title":"OpenAPI 规范","href":"/zh/api-reference/openapi-spec"}]},{"group":"REST API","pages":[{"group":"提示词","pages":[{"title":"Invoke","href":"/zh/api-reference/prompts/invoke"}]},{"group":"工作流","pages":[{"title":"Invoke","href":"/zh/api-reference/workflows/invoke"}]},{"group":"智能体","pages":[{"title":"Invoke","href":"/zh/api-reference/agents/invoke"},{"title":"工具审批","href":"/zh/api-reference/agents/tool-approvals"},{"title":"List tool action approvals","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/tool_action_approvals","href":"/api-reference/tool-action-approvals/list-tool-action-approvals"},{"title":"Show a tool action approval","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/tool_action_approvals/{id}","href":"/api-reference/tool-action-approvals/show-a-tool-action-approval"},{"title":"Decide a tool action approval","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/tool_action_approvals/{id}/decide","href":"/api-reference/tool-action-approvals/decide-a-tool-action-approval"},{"title":"Get an agent delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/agent/delegations/{id}","href":"/api-reference/agents/get-an-agent-delegation"},{"title":"Cancel an agent delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/agent/delegations/{id}/cancel","href":"/api-reference/agents/cancel-an-agent-delegation"},{"title":"List pending agent delegations for a thread","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/agent/threads/{thread_id}/delegations","href":"/api-reference/agents/list-pending-agent-delegations-for-a-thread"},{"title":"List public workspace agents","description":"Returns standalone agents scoped to the requested public API workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/list-public-workspace-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","description":"Returns a single active agent belonging to the requested workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/update-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/delete-an-agent"}]},{"group":"Hive Agents","pages":[{"title":"Invoke","href":"/zh/api-reference/hive-agents/invoke"}]},{"group":"知识库","pages":[{"title":"List public workspace knowledge bases","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases","href":"/api-reference/knowledge-bases/list-public-workspace-knowledge-bases"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/knowledge_bases","href":"/api-reference/knowledge-bases/create-a-knowledge-base"},{"title":"Get a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/get-a-knowledge-base"},{"title":"Update a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/update-a-knowledge-base"},{"title":"Delete a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/delete-a-knowledge-base"},{"title":"List public workspace knowledge base items","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}/items","href":"/api-reference/knowledge-base-items/list-public-workspace-knowledge-base-items"},{"title":"Search a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}/search","href":"/api-reference/knowledge-bases/search-a-knowledge-base"}]},{"group":"资产","pages":[{"title":"List public workspace assets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/assets","href":"/api-reference/assets/list-public-workspace-assets"},{"title":"Upload a public workspace asset","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/assets","href":"/api-reference/assets/upload-a-public-workspace-asset"}]},{"group":"模型","pages":[{"title":"List active models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/models","href":"/api-reference/models/list-active-models"}]},{"group":"请求","pages":[{"title":"Get a request","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/requests/{id}","href":"/api-reference/requests/get-a-request"}]},{"group":"搜索服务","pages":[{"title":"List public search-service country catalogs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/search_services/countries","href":"/api-reference/search-services/list-public-search-service-country-catalogs"},{"title":"Retrieve public search-service country catalog","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/search_services/{service}/countries","href":"/api-reference/search-services/retrieve-public-search-service-country-catalog"}]}]}]}]},{"language":"es","tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/es/getting-started/overview"}]},{"tab":"Referencia de la API","groups":[{"group":"Fetch Hive API","pages":[{"title":"Resumen","href":"/es/api-reference/overview"},{"title":"Autenticación","href":"/es/api-reference/authentication"},{"title":"Errores y límites de tasa","href":"/es/api-reference/errors-and-rate-limits"},{"title":"Códigos de error","href":"/es/api-reference/error-codes"},{"title":"Especificación OpenAPI","href":"/es/api-reference/openapi-spec"}]},{"group":"REST API","pages":[{"group":"Prompts","pages":[{"title":"Invoke","href":"/es/api-reference/prompts/invoke"}]},{"group":"Flujos de trabajo","pages":[{"title":"Invoke","href":"/es/api-reference/workflows/invoke"}]},{"group":"Agentes","pages":[{"title":"Invoke","href":"/es/api-reference/agents/invoke"},{"title":"Aprobaciones de herramientas","href":"/es/api-reference/agents/tool-approvals"},{"title":"List tool action approvals","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/tool_action_approvals","href":"/api-reference/tool-action-approvals/list-tool-action-approvals"},{"title":"Show a tool action approval","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/tool_action_approvals/{id}","href":"/api-reference/tool-action-approvals/show-a-tool-action-approval"},{"title":"Decide a tool action approval","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/tool_action_approvals/{id}/decide","href":"/api-reference/tool-action-approvals/decide-a-tool-action-approval"},{"title":"Get an agent delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/agent/delegations/{id}","href":"/api-reference/agents/get-an-agent-delegation"},{"title":"Cancel an agent delegation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/agent/delegations/{id}/cancel","href":"/api-reference/agents/cancel-an-agent-delegation"},{"title":"List pending agent delegations for a thread","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/agent/threads/{thread_id}/delegations","href":"/api-reference/agents/list-pending-agent-delegations-for-a-thread"},{"title":"List public workspace agents","description":"Returns standalone agents scoped to the requested public API workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/list-public-workspace-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/agents","href":"/api-reference/agents/create-an-agent"},{"title":"Get an agent","description":"Returns a single active agent belonging to the requested workspace.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/update-an-agent"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/public/workspaces/{workspace_id}/agents/{id}","href":"/api-reference/agents/delete-an-agent"}]},{"group":"Hive Agents","pages":[{"title":"Invocar desde codigo","href":"/es/api-reference/hive-agents/invoke"}]},{"group":"Bases de conocimientos","pages":[{"title":"List public workspace knowledge bases","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases","href":"/api-reference/knowledge-bases/list-public-workspace-knowledge-bases"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/knowledge_bases","href":"/api-reference/knowledge-bases/create-a-knowledge-base"},{"title":"Get a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/get-a-knowledge-base"},{"title":"Update a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/update-a-knowledge-base"},{"title":"Delete a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}","href":"/api-reference/knowledge-bases/delete-a-knowledge-base"},{"title":"List public workspace knowledge base items","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}/items","href":"/api-reference/knowledge-base-items/list-public-workspace-knowledge-base-items"},{"title":"Search a knowledge base","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/knowledge_bases/{knowledge_base_id}/search","href":"/api-reference/knowledge-bases/search-a-knowledge-base"}]},{"group":"Activos","pages":[{"title":"List public workspace assets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/workspaces/{workspace_id}/assets","href":"/api-reference/assets/list-public-workspace-assets"},{"title":"Upload a public workspace asset","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/public/workspaces/{workspace_id}/assets","href":"/api-reference/assets/upload-a-public-workspace-asset"}]},{"group":"Modelos","pages":[{"title":"List active models","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/models","href":"/api-reference/models/list-active-models"}]},{"group":"Solicitudes","pages":[{"title":"Get a request","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/requests/{id}","href":"/api-reference/requests/get-a-request"}]},{"group":"Servicios de búsqueda","pages":[{"title":"List public search-service country catalogs","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/search_services/countries","href":"/api-reference/search-services/list-public-search-service-country-catalogs"},{"title":"Retrieve public search-service country catalog","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/public/search_services/{service}/countries","href":"/api-reference/search-services/retrieve-public-search-service-country-catalog"}]}]}]}]}]},"basePath":"","title":"Create an agent - Fetch Hive","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["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","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}