{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Ag.dev","colors":{"primary":"#000000","light":"#ffffff","dark":"#000000"},"logo":{"light":"https://mintcdn.com/agdev/oetUKXtwjo3sX8wC/public/logo.svg?fit=max\u0026auto=format\u0026n=oetUKXtwjo3sX8wC\u0026q=85\u0026s=f49c1a384dcbd49ad6bf37e52388be8d","dark":"https://mintcdn.com/agdev/oetUKXtwjo3sX8wC/public/logo-inverse.svg?fit=max\u0026auto=format\u0026n=oetUKXtwjo3sX8wC\u0026q=85\u0026s=40083b03a9ea6bdfa0750317cfe25f81"},"favicon":"/public/favicon.ico","navbar":{"links":[{"href":"mailto:hi@ag.dev","label":"Support"}],"primary":{"type":"button","label":"Console","href":"https://console.ag.dev"}},"footer":{"socials":{"discord":"https://discord.gg/cPSJbuKDse"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Discord Community","icon":"discord","href":"https://discord.gg/cPSJbuKDse"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agdev","hasAudioNarration":false,"actualSubdomain":"agdev","customDomains":["docs.ag.dev"],"gitSource":{"type":"github","owner":"agdevhq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae935439a66b08814000ff7:success","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":35},{"language":"default","tag":"Drives","count":10},{"language":"default","tag":"Documentation","count":7},{"language":"default","tag":"MCP Servers","count":6},{"language":"default","tag":"Core Concepts","count":5},{"language":"default","tag":"Agents","count":5},{"language":"default","tag":"Settings","count":5},{"language":"default","tag":"Runs","count":4},{"language":"default","tag":"Versioning","count":3},{"language":"default","tag":"Getting started","count":2}]},"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":"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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/agents/create-agent","slug":"/api-reference/agents/create-agent","pageMetadata":{"title":"Create Agent","description":"Create a new agent with specified configuration and tools","deprecated":null,"version":null,"openapi":"openapi.json post /agents","href":"/api-reference/agents/create-agent","autogeneratedByOpenApi":true,"hidden":false},"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: \"Create a new agent with specified configuration and tools\"\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 Agent","description":"Create a new agent with specified configuration and tools","deprecated":null,"version":null,"openapi":"openapi.json post /agents","href":"/api-reference/agents/create-agent","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agents"],"summary":"Create Agent","description":"Create a new agent with specified configuration and tools","security":["de3e9e1c-e30f-4d6e-ad19-954a514e2e88"],"requestBody":"96a77155-8207-40bc-ad89-6b7e9def5ce8","responses":{"201":"d1a3f501-9033-4c1f-b1a6-3f8f3f5cc4b0","400":"436a5253-e4c0-4075-b934-9c572c702b27","401":"e72a7438-fe26-489e-8863-885014c9b0b5"},"method":"post","type":"path","servers":["0b870157-ee4e-4355-91c8-bd5a96e1d455"],"path":"/agents","baseUrlOptions":["https://api.ag.dev/v0.1"],"title":"Create Agent","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"modelStackId":{"type":"string","description":"The model stack to use for the agent","enum":["anthropic/default","anthropic/default-next","openai/default","openai/reasoning","openai/reasoning-low","hybrid/reasoning-low"],"isRequired":true,"uniqueKey":"modelStackId","typeLabel":"enum\u003cstring>"},"inputSchema":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"inputSchema.type","typeLabel":"string"},"properties":{"type":"object","isRequired":true,"uniqueKey":"inputSchema.properties","typeLabel":"object"},"required":{"type":"array","items":{"type":"string","uniqueKey":"inputSchema.required.items.[INDEX]","typeLabel":"string"},"uniqueKey":"inputSchema.required","typeLabel":"string[]"}},"required":["type","properties"],"additionalProperties":true,"description":"JSON schema defining the structure of input data for runs","isRequired":true,"uniqueKey":"inputSchema","typeLabel":"object"},"goalPrompt":{"type":"string","description":"The main prompt that defines what the agent should accomplish","isRequired":true,"uniqueKey":"goalPrompt","typeLabel":"string"},"tools":{"type":"array","items":{"oneOf":[{"type":"object","required":["source","type"],"properties":{"source":{"type":"string","enum":["builtin"],"isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.0.source","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["searchWeb","searchNews","browseWebsite","codeInterpreter"],"isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"tools.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["source","serverId","enabledTools"],"properties":{"source":{"type":"string","enum":["mcp"],"isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.1.source","typeLabel":"enum\u003cstring>"},"serverId":{"type":"string","description":"ID of the MCP server to use","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.1.serverId","typeLabel":"string"},"enabledTools":{"type":"array","items":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.1.enabledTools.items.[INDEX]","typeLabel":"string"},"description":"List of tools to enable from the MCP server","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.1.enabledTools","typeLabel":"string[]"}},"uniqueKey":"tools.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"tools.items.[INDEX]","typeLabel":"object"},"minItems":1,"description":"List of tools available to the agent","isRequired":true,"uniqueKey":"tools","typeLabel":"object[]"},"resultType":{"type":"string","enum":["document","json"],"description":"Type of result the agent should produce","isRequired":true,"uniqueKey":"resultType","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"Optional human-readable name for the agent","uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","description":"Optional human-readable description for the agent","uniqueKey":"description","typeLabel":"string"},"webhookUrl":{"oneOf":[{"type":"string","format":"uri","description":"URL to receive webhook notifications when runs complete","uniqueKey":"webhookUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"URL to receive webhook notifications when runs complete","uniqueKey":"webhookUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhookUrl","typeLabel":"string\u003curi> | null"},"customPlanningInstructions":{"oneOf":[{"type":"string","description":"Optional custom instructions for the planning phase","uniqueKey":"customPlanningInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional custom instructions for the planning phase","uniqueKey":"customPlanningInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"customPlanningInstructions","typeLabel":"string | null"},"customToolCallInstructions":{"oneOf":[{"type":"string","description":"Optional custom instructions for tool calling","uniqueKey":"customToolCallInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional custom instructions for tool calling","uniqueKey":"customToolCallInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"customToolCallInstructions","typeLabel":"string | null"},"customResultInstructions":{"oneOf":[{"type":"string","description":"Optional custom instructions for result formatting","uniqueKey":"customResultInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional custom instructions for result formatting","uniqueKey":"customResultInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"customResultInstructions","typeLabel":"string | null"},"enableContextCompression":{"type":"boolean","default":true,"description":"Whether to enable context compression when agent run becomes too long","uniqueKey":"enableContextCompression","typeLabel":"boolean"},"resultSchema":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"resultSchema.oneOf.0.type","typeLabel":"string"},"properties":{"type":"object","isRequired":true,"uniqueKey":"resultSchema.oneOf.0.properties","typeLabel":"object"},"required":{"type":"array","items":{"type":"string","uniqueKey":"resultSchema.oneOf.0.required.items.[INDEX]","typeLabel":"string"},"uniqueKey":"resultSchema.oneOf.0.required","typeLabel":"string[]"}},"required":["type","properties"],"additionalProperties":true,"description":"JSON schema for result validation (required when resultType is 'json')","uniqueKey":"resultSchema.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"type":{"type":"string"},"properties":{"type":"object"},"required":{"type":"array","items":{"type":"string"}}},"required":["type","properties"],"additionalProperties":true,"description":"JSON schema for result validation (required when resultType is 'json')","uniqueKey":"resultSchema.oneOf.1","typeLabel":"null"}],"uniqueKey":"resultSchema","typeLabel":"object | null"}},"required":["modelStackId","goalPrompt","inputSchema","tools","resultType"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"inputSchema":{"type":"\u003cstring>","properties":{},"required":["\u003cstring>"]},"goalPrompt":"\u003cstring>","tools":[{"source":"builtin"}],"name":"\u003cstring>","description":"\u003cstring>","webhookUrl":"\u003cstring>","customPlanningInstructions":"\u003cstring>","customToolCallInstructions":"\u003cstring>","customResultInstructions":"\u003cstring>","enableContextCompression":true,"resultSchema":{"type":"\u003cstring>","properties":{},"required":["\u003cstring>"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d1a3f501-9033-4c1f-b1a6-3f8f3f5cc4b0":{"description":"Agent created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the agent","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"modelStackId":{"type":"string","description":"The model stack used by the agent","isRequired":true,"uniqueKey":"modelStackId","typeLabel":"string"},"inputSchema":{"type":"object","description":"JSON schema defining input structure","isRequired":true,"uniqueKey":"inputSchema","typeLabel":"object"},"goalPrompt":{"type":"string","description":"The main goal prompt for the agent","isRequired":true,"uniqueKey":"goalPrompt","typeLabel":"string"},"tools":{"type":"array","items":{"oneOf":[{"type":"object","required":["source","type"],"properties":{"source":{"type":"string","enum":["builtin"],"isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.0.source","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["searchWeb","searchNews","browseWebsite","codeInterpreter"],"isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"tools.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["source","serverId","enabledTools"],"properties":{"source":{"type":"string","enum":["mcp"],"isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.1.source","typeLabel":"enum\u003cstring>"},"serverId":{"type":"string","description":"ID of the MCP server to use","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.1.serverId","typeLabel":"string"},"enabledTools":{"type":"array","items":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.1.enabledTools.items.[INDEX]","typeLabel":"string"},"description":"List of tools to enable from the MCP server","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.1.enabledTools","typeLabel":"string[]"}},"uniqueKey":"tools.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"tools.items.[INDEX]","typeLabel":"object"},"description":"Available tools for the agent","isRequired":true,"uniqueKey":"tools","typeLabel":"object[]"},"resultType":{"type":"string","enum":["document","json"],"description":"Type of result the agent produces","isRequired":true,"uniqueKey":"resultType","typeLabel":"enum\u003cstring>"},"isActive":{"type":"boolean","description":"Whether the agent is active","isRequired":true,"uniqueKey":"isActive","typeLabel":"boolean"},"createdAt":{"type":"string","format":"date-time","description":"Agent creation timestamp","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"Agent last update timestamp","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"name":{"oneOf":[{"type":"string","description":"Human-readable name for the agent","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name for the agent","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"Human-readable description for the agent","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable description for the agent","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"webhookUrl":{"oneOf":[{"type":"string","format":"uri","description":"Webhook URL for run completion notifications","uniqueKey":"webhookUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Webhook URL for run completion notifications","uniqueKey":"webhookUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhookUrl","typeLabel":"string\u003curi> | null"},"customPlanningInstructions":{"oneOf":[{"type":"string","description":"Custom planning instructions","uniqueKey":"customPlanningInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Custom planning instructions","uniqueKey":"customPlanningInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"customPlanningInstructions","typeLabel":"string | null"},"customToolCallInstructions":{"oneOf":[{"type":"string","description":"Custom tool call instructions","uniqueKey":"customToolCallInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Custom tool call instructions","uniqueKey":"customToolCallInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"customToolCallInstructions","typeLabel":"string | null"},"customResultInstructions":{"oneOf":[{"type":"string","description":"Custom result formatting instructions","uniqueKey":"customResultInstructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Custom result formatting instructions","uniqueKey":"customResultInstructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"customResultInstructions","typeLabel":"string | null"},"enableContextCompression":{"type":"boolean","description":"Whether context compression is enabled","uniqueKey":"enableContextCompression","typeLabel":"boolean"},"resultSchema":{"oneOf":[{"type":"object","description":"JSON schema for result validation (only for json result type)","uniqueKey":"resultSchema.oneOf.0","typeLabel":"object"},{"type":"null","description":"JSON schema for result validation (only for json result type)","uniqueKey":"resultSchema.oneOf.1","typeLabel":"null"}],"uniqueKey":"resultSchema","typeLabel":"object | null"}},"required":["id","modelStackId","inputSchema","goalPrompt","tools","resultType","isActive","createdAt","updatedAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","modelStackId":"\u003cstring>","inputSchema":{},"goalPrompt":"\u003cstring>","tools":[{"source":"builtin","type":"searchWeb"}],"resultType":"document","isActive":true,"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","name":"\u003cstring>","description":"\u003cstring>","webhookUrl":"\u003cstring>","customPlanningInstructions":"\u003cstring>","customToolCallInstructions":"\u003cstring>","customResultInstructions":"\u003cstring>","enableContextCompression":true,"resultSchema":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"436a5253-e4c0-4075-b934-9c572c702b27":{"description":"Invalid request data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"e72a7438-fe26-489e-8863-885014c9b0b5":{"description":"Authentication required","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"de3e9e1c-e30f-4d6e-ad19-954a514e2e88":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Provide either X-API-Key: \u003ckey> or Authorization: Bearer \u003ckey>","scopes":[]}}},"servers":{"0b870157-ee4e-4355-91c8-bd5a96e1d455":{"url":"https://api.ag.dev/v0.1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Provide either X-API-Key: \u003ckey> or Authorization: Bearer \u003ckey>","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Provide either X-API-Key: \u003ckey> or Authorization: Bearer \u003ckey>","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"agdev","siteName":"Ag.dev","title":"Create Agent - Ag.dev","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-17T01:01:54.919Z","originalFileLocation":"api-reference/agents/create-agent.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=\"Create a new agent with specified configuration and tools\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ag.dev\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agdev/QZ65LCQS0SV-UsSQ/_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/agdev/QZ65LCQS0SV-UsSQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agdev/QZ65LCQS0SV-UsSQ/_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/agdev/QZ65LCQS0SV-UsSQ/_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/agdev/QZ65LCQS0SV-UsSQ/_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/agdev/QZ65LCQS0SV-UsSQ/_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/agdev/QZ65LCQS0SV-UsSQ/_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/agdev/QZ65LCQS0SV-UsSQ/_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/agdev/QZ65LCQS0SV-UsSQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Agent - Ag.dev\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new agent with specified configuration and tools\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ag.dev\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ag.dev/api-reference/agents/create-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agdev.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+Agent\u0026amp;description=Create+a+new+agent+with+specified+configuration+and+tools\u0026amp;theme=b4785e5ca2ef58904cdf9bab\u0026amp;signature=73e639b04ad5c6183a6bdd96ad4affbc2669fdf4a017d79bb9d14bc6b7366ca7\">\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 Agent - Ag.dev\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new agent with specified configuration and tools\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agdev.mintlify.site/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+Agent\u0026amp;description=Create+a+new+agent+with+specified+configuration+and+tools\u0026amp;theme=b4785e5ca2ef58904cdf9bab\u0026amp;signature=73e639b04ad5c6183a6bdd96ad4affbc2669fdf4a017d79bb9d14bc6b7366ca7\">\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/agdev/QZ65LCQS0SV-UsSQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ag.dev\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ag.dev/api-reference/agents/create-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-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ag.dev/#organization\",\"name\":\"Ag.dev\",\"url\":\"https://docs.ag.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agdev/oetUKXtwjo3sX8wC/public/logo.svg?fit=max\u0026auto=format\u0026n=oetUKXtwjo3sX8wC\u0026q=85\u0026s=f49c1a384dcbd49ad6bf37e52388be8d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ag.dev#website\",\"name\":\"Ag.dev\",\"url\":\"https://docs.ag.dev\",\"publisher\":{\"@id\":\"https://docs.ag.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ag.dev/api-reference/agents/create-agent#webpage\",\"url\":\"https://docs.ag.dev/api-reference/agents/create-agent\",\"name\":\"Create Agent\",\"description\":\"Create a new agent with specified configuration and tools\",\"dateModified\":\"2026-01-17T01:01:54.919Z\",\"isPartOf\":{\"@id\":\"https://docs.ag.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ag.dev/api-reference/agents/create-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ag.dev/api-reference/agents/create-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.ag.dev/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Agent\",\"item\":\"https://docs.ag.dev/api-reference/agents/create-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ag.dev/api-reference/agents/create-agent#apireference\",\"headline\":\"Create Agent\",\"name\":\"Create Agent\",\"description\":\"Create a new agent with specified configuration and tools\",\"url\":\"https://docs.ag.dev/api-reference/agents/create-agent\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ag.dev/api-reference/agents/create-agent#webpage\"},\"dateModified\":\"2026-01-17T01:01:54.919Z\",\"publisher\":{\"@id\":\"https://docs.ag.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ag.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ag.dev\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ag.dev\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/agents/create-agent.md","siteName":"Ag.dev","nav":{"global":{"anchors":[{"anchor":"Discord Community","icon":"discord","href":"https://discord.gg/cPSJbuKDse"}]},"dropdowns":[{"dropdown":"Documentation","icon":"book","description":"Learn how to use Ag.dev","groups":[{"group":"Getting started","pages":[{"title":"Introduction","icon":"book-open","href":""},{"title":"Quickstart","icon":"rocket","href":"/quickstart"}]},{"group":"Core Concepts","pages":[{"title":"Agents","icon":"bot","href":"/concepts/agents"},{"title":"Agent Versioning","sidebarTitle":"Versioning","icon":"git-commit-vertical","href":"/concepts/versioning"},{"title":"Runs","icon":"square-play","href":"/concepts/runs"},{"title":"Tools","icon":"wrench","href":"/concepts/tools"},{"title":"Inputs","icon":"braces","href":"/concepts/inputs"}]}]},{"dropdown":"API Reference","icon":"terminal","description":"Using the Ag.dev API","groups":[{"group":"Agents","pages":[{"title":"List Agents","description":"Retrieve all agents for the authenticated organization","deprecated":null,"version":null,"openapi":"openapi.json get /agents","href":"/api-reference/agents/list-agents"},{"title":"Create Agent","deprecated":null,"version":null,"openapi":"openapi.json post /agents","href":"/api-reference/agents/create-agent"},{"title":"Get Agent","description":"Retrieve detailed information about a specific agent","deprecated":null,"version":null,"openapi":"openapi.json get /agents/{agentId}","href":"/api-reference/agents/get-agent"},{"title":"Delete Agent","deprecated":null,"version":null,"openapi":"openapi.json delete /agents/{agentId}","href":"/api-reference/agents/delete-agent"},{"title":"Update Agent","deprecated":null,"version":null,"openapi":"openapi.json patch /agents/{agentId}","href":"/api-reference/agents/update-agent"}]},{"group":"Versioning","pages":[{"title":"Publish Agent Revision","deprecated":null,"version":null,"openapi":"openapi.json post /agents/{agentId}/publish","href":"/api-reference/versioning/publish-agent-revision"},{"title":"List Agent Revisions","deprecated":null,"version":null,"openapi":"openapi.json get /agents/{agentId}/revisions","href":"/api-reference/versioning/list-agent-revisions"},{"title":"Get Revision Diff","deprecated":null,"version":null,"openapi":"openapi.json get /agents/{agentId}/revisions/diff","href":"/api-reference/versioning/get-revision-diff"}]},{"group":"Runs","pages":[{"title":"List Agent Runs","deprecated":null,"version":null,"openapi":"openapi.json get /agents/{agentId}/runs","href":"/api-reference/runs/list-agent-runs"},{"title":"Start Agent Run","deprecated":null,"version":null,"openapi":"openapi.json post /agents/{agentId}/runs","href":"/api-reference/runs/start-agent-run"},{"title":"Get Agent Run","deprecated":null,"version":null,"openapi":"openapi.json get /agents/{agentId}/runs/{runId}","href":"/api-reference/runs/get-agent-run"},{"title":"List Agent Run Events","deprecated":null,"version":null,"openapi":"openapi.json get /agents/{agentId}/runs/{runId}/events","href":"/api-reference/runs/list-agent-run-events"}]},{"group":"Drives","pages":[{"title":"List Drives","deprecated":null,"version":null,"openapi":"openapi.json get /drives","href":"/api-reference/drives/list-drives"},{"title":"Create Drive","deprecated":null,"version":null,"openapi":"openapi.json post /drives","href":"/api-reference/drives/create-drive"},{"title":"Get Drive","deprecated":null,"version":null,"openapi":"openapi.json get /drives/{driveId}","href":"/api-reference/drives/get-drive"},{"title":"Delete Drive","deprecated":null,"version":null,"openapi":"openapi.json delete /drives/{driveId}","href":"/api-reference/drives/delete-drive"},{"title":"List Drive Items","deprecated":null,"version":null,"openapi":"openapi.json get /drives/{driveId}/items","href":"/api-reference/drives/list-drive-items"},{"title":"Upload Drive File","deprecated":null,"version":null,"openapi":"openapi.json post /drives/{driveId}/items","href":"/api-reference/drives/upload-drive-file"},{"title":"Get Drive File","deprecated":null,"version":null,"openapi":"openapi.json get /drives/{driveId}/files/{fileId}","href":"/api-reference/drives/get-drive-file"},{"title":"Delete Drive File","deprecated":null,"version":null,"openapi":"openapi.json delete /drives/{driveId}/files/{fileId}","href":"/api-reference/drives/delete-drive-file"},{"title":"Update Drive File","deprecated":null,"version":null,"openapi":"openapi.json patch /drives/{driveId}/files/{fileId}","href":"/api-reference/drives/update-drive-file"},{"title":"Delete Drive Tree","deprecated":null,"version":null,"openapi":"openapi.json delete /drives/{driveId}/items/tree","href":"/api-reference/drives/delete-drive-tree"}]},{"group":"MCP Servers","pages":[{"title":"List MCP Servers","deprecated":null,"version":null,"openapi":"openapi.json get /mcp-servers","href":"/api-reference/mcp-servers/list-mcp-servers"},{"title":"Create MCP Server","deprecated":null,"version":null,"openapi":"openapi.json post /mcp-servers","href":"/api-reference/mcp-servers/create-mcp-server"},{"title":"Get MCP Server","deprecated":null,"version":null,"openapi":"openapi.json get /mcp-servers/{mcpServerId}","href":"/api-reference/mcp-servers/get-mcp-server"},{"title":"Delete MCP Server","deprecated":null,"version":null,"openapi":"openapi.json delete /mcp-servers/{mcpServerId}","href":"/api-reference/mcp-servers/delete-mcp-server"},{"title":"Update MCP Server","deprecated":null,"version":null,"openapi":"openapi.json patch /mcp-servers/{mcpServerId}","href":"/api-reference/mcp-servers/update-mcp-server"},{"title":"List MCP Server Tools","deprecated":null,"version":null,"openapi":"openapi.json get /mcp-servers/{mcpServerId}/tools","href":"/api-reference/mcp-servers/list-mcp-server-tools"}]},{"group":"Settings","pages":[{"title":"Get Organization Settings","deprecated":null,"version":null,"openapi":"openapi.json get /settings","href":"/api-reference/settings/get-organization-settings"},{"title":"Update Organization Settings","deprecated":null,"version":null,"openapi":"openapi.json patch /settings","href":"/api-reference/settings/update-organization-settings"},{"title":"Get API Keys","deprecated":null,"version":null,"openapi":"openapi.json get /settings/api-keys","href":"/api-reference/settings/get-api-keys"},{"title":"Update API Keys","deprecated":null,"version":null,"openapi":"openapi.json patch /settings/api-keys","href":"/api-reference/settings/update-api-keys"},{"title":"Get Credit Balance","deprecated":null,"version":null,"openapi":"openapi.json get /settings/credits","href":"/api-reference/settings/get-credit-balance"}]},{"group":"Users","pages":[{"title":"Get Current User","deprecated":null,"version":null,"openapi":"openapi.json get /users/me","href":"/api-reference/users/get-current-user"}]},{"group":"Webhooks","pages":[{"title":"Agent run completed","version":null,"deprecated":null,"openapi":"openapi.json webhook onRunCompleted","href":"/api-reference/webhooks/agent-run-completed"}]}]}]},"basePath":"","title":"Create Agent - Ag.dev","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","Page-Cr9IwkK7.js","CodeSnippet-eoRjC4Le.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","getApiPlaygroundDisplay-CZyAPlR2.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}