Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.
Input schema for GraphWorkflow completion requests.
name
string | null
The name of the graph workflow.
description
string | null
The description of the graph workflow.
agents
AgentSpec · object[] | null
List of agent specifications to be used as nodes in the workflow graph. At most 2000.
Maximum array length: 2000
Show child attributes
edges
(EdgeSpec · object | object)[] | null
List of edges connecting nodes. Can be EdgeSpec objects or dictionaries with 'source' and 'target' keys. The edges must not form a cycle: a cyclic graph returns 400.
Schema for defining an edge between nodes in the workflow graph.
EdgeSpec
Option 2
Show child attributes
entry_points
string[] | null
List of node IDs that serve as starting points for the workflow.
end_points
string[] | null
List of node IDs that serve as ending points for the workflow.
max_loops
integer | null
default:1
The maximum number of execution loops for the workflow.
task
string | null
The task to be executed by the workflow. Required: a missing or blank task returns 400.
img
string | null
Optional https:// image URL or base64 encoded image for vision-enabled agents.
auto_compile
boolean | null
default:true
Whether to automatically compile the workflow for optimization.
verbose
boolean | null
default:false
Whether to enable detailed logging.
Response
Successful Response
Output schema for GraphWorkflow completion responses.
job_id
string
required
The job ID of the graph workflow.
status
string
required
The status of the graph workflow.
outputs
any
required
The outputs of the graph workflow.
usage
Usage · object
required
The usage statistics of the workflow.
Show child attributes
timestamp
string
required
The timestamp of the graph workflow execution.
name
string | null
The name of the graph workflow.
description
string | null
The description of the graph workflow.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Swarms API Documentation","description":"Build intelligent AI agents and multi-agent swarms with the Swarms API. Create single agents, reasoning systems, and enterprise-scale swarms for automation, research, and complex problem-solving.","colors":{"primary":"#DC2626","light":"#FFFFFF","dark":"#000000"},"logo":{"light":"https://mintcdn.com/swarms/0uhx6ZFxLaCyzbhr/logo/light.svg?fit=max\u0026auto=format\u0026n=0uhx6ZFxLaCyzbhr\u0026q=85\u0026s=0c5b6851cc5173c655702a17160d54c5","dark":"https://mintcdn.com/swarms/0uhx6ZFxLaCyzbhr/logo/dark.svg?fit=max\u0026auto=format\u0026n=0uhx6ZFxLaCyzbhr\u0026q=85\u0026s=205e7749182b1789a69fa9e73ab35cfe"},"favicon":"https://mintcdn.com/swarms/0uhx6ZFxLaCyzbhr/logo.svg?fit=max\u0026auto=format\u0026n=0uhx6ZFxLaCyzbhr\u0026q=85\u0026s=a6cfd5b1a6d954eb010573a52b5a0e20","api":{"openapi":"https://api.swarms.world/openapi.json","playground":{"proxy":true}},"navbar":{"links":[{"icon":"key","href":"https://swarms.world/platform/api-keys","label":"Get API Key"},{"icon":"user","href":"https://swarms.world/platform/account","label":"Account Management"},{"icon":"headset","href":"https://cal.com/swarms/swarms-technical-support?overlayCalendar=true","label":"Support"},{"icon":"lightbulb","href":"https://status.swarms.ai","label":"Status"}]},"footer":{"socials":{"twitter":"https://twitter.com/swarms_corp","github":"https://github.com/The-Swarm-Corporation/swarms-api-docs","linkedin":"https://www.linkedin.com/company/the-swarm-corporation","discord":"https://discord.gg/EamjgSaEQf","youtube":"https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ","medium":"https://medium.com/@kyeg"}},"seo":{"metatags":{"charset":"UTF-8","viewport":"width=device-width, initial-scale=1.0","robots":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1","googlebot":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1","google":"notranslate","generator":"Mintlify","theme-color":"#DC2626","color-scheme":"light dark","canonical":"https://docs.swarms.ai","format-detection":"telephone=no","referrer":"strict-origin-when-cross-origin","language":"en","copyright":"Copyright 2024 The Swarm Corporation","distribution":"global","coverage":"Worldwide","category":"Technology","target":"all","rating":"general","revisit-after":"3 days","HandheldFriendly":"True","MobileOptimized":"320","apple-mobile-web-app-capable":"yes","apple-mobile-web-app-status-bar-style":"black-translucent","apple-mobile-web-app-title":"Swarms API Docs","application-name":"Swarms API Documentation","msapplication-TileColor":"#DC2626","msapplication-navbutton-color":"#DC2626","og:title":"Swarms API Documentation - Build AI Agents \u0026 Multi-Agent Systems","og:type":"website","og:url":"https://docs.swarms.ai","og:image":"https://docs.swarms.ai/bg.jpg","og:image:width":"1200","og:image:height":"630","og:image:alt":"Swarms API Documentation - Build intelligent AI agents and multi-agent swarms","og:description":"Create intelligent AI agents and multi-agent swarms with the Swarms API. Support for OpenAI, Anthropic, and Groq models with enterprise-scale orchestration.","og:site_name":"Swarms API Documentation","og:locale":"en_US","twitter:card":"summary_large_image","twitter:site":"@swarms_corp","twitter:creator":"@kyegomez","twitter:title":"Swarms API Documentation - Build AI Agents \u0026 Multi-Agent Swarms","twitter:description":"Create intelligent AI agents and multi-agent swarms with the Swarms API. Support for OpenAI, Anthropic, and Groq models.","twitter:image":"https://docs.swarms.ai/bg.jpg","twitter:image:alt":"Swarms API Documentation - Build intelligent AI agents and multi-agent swarms","article:author":"The Swarm Corporation","article:section":"Technology","article:tag":"AI agents, multi-agent systems, swarm intelligence, API documentation, artificial intelligence"},"indexing":"all"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Get Your API Key","href":"https://swarms.world/platform/api-keys"},{"anchor":"Account Management","href":"https://swarms.world/platform/account"},{"anchor":"Discord","href":"https://discord.gg/EamjgSaEQf"},{"anchor":"Technical Support","href":"https://cal.com/swarms/swarms-technical-support?overlayCalendar=true"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"swarms","hasAudioNarration":false,"actualSubdomain":"swarms","customDomains":["docs.swarms.ai"],"gitSource":{"type":"github","owner":"the-swarm-corporation","repo":"swarms-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6afca01379699ae4557ab6a7","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Examples","count":108},{"language":"default","tag":"Swarms API","count":64},{"language":"default","tag":"Marketplace","count":41},{"language":"default","tag":"API Reference","count":32},{"language":"default","tag":"Multi-Agent","count":19},{"language":"default","tag":"Resources","count":19},{"language":"default","tag":"Multi-Agent Architectures","count":18},{"language":"default","tag":"Agent Capabilities","count":15},{"language":"default","tag":"Finance \u0026 Investing","count":14},{"language":"default","tag":"API","count":14}]},"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/graph-workflow/execute-graph-workflow","slug":"/api-reference/graph-workflow/execute-graph-workflow","pageMetadata":{"title":"Execute Graph Workflow","description":"Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/graph-workflow/completions","href":"/api-reference/graph-workflow/execute-graph-workflow","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: \"Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.\"\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":"Execute Graph Workflow","description":"Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/graph-workflow/completions","href":"/api-reference/graph-workflow/execute-graph-workflow","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Graph Workflow"],"summary":"Execute Graph Workflow","description":"Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.","operationId":"run_graph_workflow_v1_graph_workflow_completions_post","parameters":["3104b19f-5232-44c0-a3d5-ea1fc6b41fef"],"requestBody":"af2da601-6a34-40d6-99cc-c676b917e0a0","responses":{"200":"44d47000-c3ff-4cb2-bb3f-b618b6817de6","422":"cf2b45f3-172e-4cd6-883c-fa74e38ff178"},"method":"post","type":"path","servers":["c2dfd685-4751-40be-ab07-129d372d97a4"],"security":[],"path":"/v1/graph-workflow/completions","baseUrlOptions":["https://api.swarms.world"],"title":"Execute Graph Workflow","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3104b19f-5232-44c0-a3d5-ea1fc6b41fef":{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string","title":"X-Api-Key","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"oneOf":[{"type":"string","title":"Name","description":"The name of the graph workflow.","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"The name of the graph workflow.","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","description":"The description of the graph workflow.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"The description of the graph workflow.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"agents":{"oneOf":[{"type":"array","items":{"properties":{"agent_name":{"oneOf":[{"type":"string","title":"Agent Name","description":"The unique name assigned to the agent, which identifies its role and functionality within the swarm. Required unless marketplace_prompt_id is set.","uniqueKey":"agents.oneOf.0.items.[INDEX].agent_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Agent Name","description":"The unique name assigned to the agent, which identifies its role and functionality within the swarm. Required unless marketplace_prompt_id is set.","uniqueKey":"agents.oneOf.0.items.[INDEX].agent_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].agent_name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","description":"A detailed explanation of the agent's purpose, capabilities, and any specific tasks it is designed to perform.","uniqueKey":"agents.oneOf.0.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"A detailed explanation of the agent's purpose, capabilities, and any specific tasks it is designed to perform.","uniqueKey":"agents.oneOf.0.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].description","typeLabel":"string | null"},"system_prompt":{"oneOf":[{"type":"string","title":"System Prompt","description":"The initial instruction or context provided to the agent, guiding its behavior and responses during execution.","uniqueKey":"agents.oneOf.0.items.[INDEX].system_prompt.oneOf.0","typeLabel":"string"},{"type":"null","title":"System Prompt","description":"The initial instruction or context provided to the agent, guiding its behavior and responses during execution.","uniqueKey":"agents.oneOf.0.items.[INDEX].system_prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].system_prompt","typeLabel":"string | null"},"marketplace_prompt_id":{"oneOf":[{"type":"string","title":"Marketplace Prompt Id","description":"The ID of a prompt from the Swarms marketplace to use as the system prompt. If provided, the prompt will be automatically retrieved from the marketplace.","uniqueKey":"agents.oneOf.0.items.[INDEX].marketplace_prompt_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Marketplace Prompt Id","description":"The ID of a prompt from the Swarms marketplace to use as the system prompt. If provided, the prompt will be automatically retrieved from the marketplace.","uniqueKey":"agents.oneOf.0.items.[INDEX].marketplace_prompt_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].marketplace_prompt_id","typeLabel":"string | null"},"model_name":{"oneOf":[{"type":"string","title":"Model Name","description":"The name of the AI model that the agent will utilize for processing tasks and generating outputs. For example: gpt-5.4, claude-sonnet-5, openrouter/moonshotai/kimi-k3","default":"claude-sonnet-5","uniqueKey":"agents.oneOf.0.items.[INDEX].model_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model Name","description":"The name of the AI model that the agent will utilize for processing tasks and generating outputs. For example: gpt-5.4, claude-sonnet-5, openrouter/moonshotai/kimi-k3","default":"claude-sonnet-5","uniqueKey":"agents.oneOf.0.items.[INDEX].model_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].model_name","typeLabel":"string | null"},"fallback_models":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].fallback_models.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Fallback Models","description":"An ordered list of models to try if the primary model errors: the request is retried with the next model on failure. If set while model_name is omitted, the first entry becomes the primary model. Example: ['claude-sonnet-5', 'gpt-5.4'].","uniqueKey":"agents.oneOf.0.items.[INDEX].fallback_models.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Fallback Models","description":"An ordered list of models to try if the primary model errors: the request is retried with the next model on failure. If set while model_name is omitted, the first entry becomes the primary model. Example: ['claude-sonnet-5', 'gpt-5.4'].","uniqueKey":"agents.oneOf.0.items.[INDEX].fallback_models.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].fallback_models","typeLabel":"string[] | null"},"fallback_model_name":{"oneOf":[{"type":"string","title":"Fallback Model Name","description":"A single fallback model to try if the primary model fails, tried after any `fallback_models`. Example: 'openrouter/deepseek/deepseek-v4.1-flash'.","uniqueKey":"agents.oneOf.0.items.[INDEX].fallback_model_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Fallback Model Name","description":"A single fallback model to try if the primary model fails, tried after any `fallback_models`. Example: 'openrouter/deepseek/deepseek-v4.1-flash'.","uniqueKey":"agents.oneOf.0.items.[INDEX].fallback_model_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].fallback_model_name","typeLabel":"string | null"},"auto_generate_prompt":{"oneOf":[{"type":"boolean","title":"Auto Generate Prompt","description":"A flag indicating whether the agent should automatically create prompts based on the task requirements.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].auto_generate_prompt.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Auto Generate Prompt","description":"A flag indicating whether the agent should automatically create prompts based on the task requirements.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].auto_generate_prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].auto_generate_prompt","typeLabel":"boolean | null"},"max_tokens":{"oneOf":[{"type":"integer","title":"Max Tokens","description":"The maximum number of tokens that the agent is allowed to generate in its responses, limiting output length. Must be at least 1.","default":16000,"minimum":1,"uniqueKey":"agents.oneOf.0.items.[INDEX].max_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Tokens","description":"The maximum number of tokens that the agent is allowed to generate in its responses, limiting output length. Must be at least 1.","default":16000,"uniqueKey":"agents.oneOf.0.items.[INDEX].max_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].max_tokens","typeLabel":"integer | null"},"temperature":{"oneOf":[{"type":"number","title":"Temperature","description":"A parameter that controls the randomness of the agent's output; lower values result in more deterministic responses. Accepted range: 0 to 2. If omitted, no temperature is sent to the model (the provider's own default applies).","maximum":2,"minimum":0,"uniqueKey":"agents.oneOf.0.items.[INDEX].temperature.oneOf.0","typeLabel":"number"},{"type":"null","title":"Temperature","description":"A parameter that controls the randomness of the agent's output; lower values result in more deterministic responses. Accepted range: 0 to 2. If omitted, no temperature is sent to the model (the provider's own default applies).","uniqueKey":"agents.oneOf.0.items.[INDEX].temperature.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].temperature","typeLabel":"number | null"},"role":{"oneOf":[{"type":"string","title":"Role","description":"The designated role of the agent within the swarm, which influences its behavior and interaction with other agents.","default":"worker","uniqueKey":"agents.oneOf.0.items.[INDEX].role.oneOf.0","typeLabel":"string"},{"type":"null","title":"Role","description":"The designated role of the agent within the swarm, which influences its behavior and interaction with other agents.","default":"worker","uniqueKey":"agents.oneOf.0.items.[INDEX].role.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].role","typeLabel":"string | null"},"max_loops":{"oneOf":[{"type":"integer","title":"Max Loops","description":"Maximum number of iterations the agent can perform for its task. Accepts an integer from 1 to 50 for a fixed count, or 'auto' to allow the system to determine the necessary number based on the task's complexity.","default":1,"uniqueKey":"agents.oneOf.0.items.[INDEX].max_loops.oneOf.0","typeLabel":"integer"},{"type":"string","title":"Max Loops","description":"Maximum number of iterations the agent can perform for its task. Accepts an integer from 1 to 50 for a fixed count, or 'auto' to allow the system to determine the necessary number based on the task's complexity.","default":1,"uniqueKey":"agents.oneOf.0.items.[INDEX].max_loops.oneOf.1","typeLabel":"string"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].max_loops","typeLabel":"integer | string"},"tools_list_dictionary":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"agents.oneOf.0.items.[INDEX].tools_list_dictionary.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Tools List Dictionary","description":"A dictionary of tools that the agent can use to complete its task.","uniqueKey":"agents.oneOf.0.items.[INDEX].tools_list_dictionary.oneOf.0","typeLabel":"Tools List Dictionary · object[]"},{"type":"null","title":"Tools List Dictionary","description":"A dictionary of tools that the agent can use to complete its task.","uniqueKey":"agents.oneOf.0.items.[INDEX].tools_list_dictionary.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].tools_list_dictionary","typeLabel":"Tools List Dictionary · object[] | null"},"selected_tools":{"oneOf":[{"type":"string","title":"Selected Tools","description":"Tools to enable for the autonomous looper when max_loops='auto'. Pass one tool name or a list of tool names to restrict which tools the agent can use, or 'all' or omit to allow all safe defaults. An unknown name returns 422. Available tools: create_plan, think, subtask_done, complete_task, respond_to_user, create_sub_agent, assign_task. Shell and file tools (run_bash, create_file, update_file, read_file, list_directory, delete_file) are not permitted and return 422.","uniqueKey":"agents.oneOf.0.items.[INDEX].selected_tools.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].selected_tools.oneOf.1.items.[INDEX]","typeLabel":"string"},"title":"Selected Tools","description":"Tools to enable for the autonomous looper when max_loops='auto'. Pass one tool name or a list of tool names to restrict which tools the agent can use, or 'all' or omit to allow all safe defaults. An unknown name returns 422. Available tools: create_plan, think, subtask_done, complete_task, respond_to_user, create_sub_agent, assign_task. Shell and file tools (run_bash, create_file, update_file, read_file, list_directory, delete_file) are not permitted and return 422.","uniqueKey":"agents.oneOf.0.items.[INDEX].selected_tools.oneOf.1","typeLabel":"string[]"},{"type":"null","title":"Selected Tools","description":"Tools to enable for the autonomous looper when max_loops='auto'. Pass one tool name or a list of tool names to restrict which tools the agent can use, or 'all' or omit to allow all safe defaults. An unknown name returns 422. Available tools: create_plan, think, subtask_done, complete_task, respond_to_user, create_sub_agent, assign_task. Shell and file tools (run_bash, create_file, update_file, read_file, list_directory, delete_file) are not permitted and return 422.","uniqueKey":"agents.oneOf.0.items.[INDEX].selected_tools.oneOf.2","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].selected_tools","typeLabel":"string | string[] | null"},"mcp_url":{"oneOf":[{"type":"string","title":"Mcp Url","description":"The MCP server the agent can use to complete its task. An https:// URL string for an unauthenticated server, or a connection object configuring auth and transport.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.0","typeLabel":"string"},{"type":"object","title":"MCPConnection","description":"The MCP server the agent can use to complete its task. An https:// URL string for an unauthenticated server, or a connection object configuring auth and transport.","properties":{"type":{"oneOf":[{"type":"string","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.type","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.name","typeLabel":"string | null"},"tool_configurations":{"oneOf":[{"type":"object","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.tool_configurations.oneOf.0","typeLabel":"Tool Configurations · object"},{"type":"null","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.tool_configurations.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.tool_configurations","typeLabel":"Tool Configurations · object | null"},"authorization_token":{"oneOf":[{"type":"string","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.authorization_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.authorization_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.authorization_token","typeLabel":"string | null"},"api_key":{"oneOf":[{"type":"string","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.api_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.api_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.api_key","typeLabel":"string | null"},"api_key_header":{"type":"string","title":"Api Key Header","description":"Header used to send the API key, e.g. 'Authorization' or 'X-API-Key'.","default":"Authorization","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.api_key_header","typeLabel":"string"},"api_key_prefix":{"oneOf":[{"type":"string","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.api_key_prefix.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.api_key_prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.api_key_prefix","typeLabel":"string | null"},"auth_type":{"oneOf":[{"type":"string","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","enum":["none","api_key","bearer","oauth","custom"],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.auth_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.auth_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.auth_type","typeLabel":"enum\u003cstring> | null"},"oauth":{"oneOf":[{"type":"object","title":"MCPOAuthConfig","description":"OAuth 2.1 configuration for this server.","properties":{"grant_type":{"type":"string","enum":["authorization_code","client_credentials"],"title":"Grant Type","description":"OAuth grant to use when no static access_token is supplied.","default":"authorization_code","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.grant_type","typeLabel":"enum\u003cstring>"},"client_id":{"oneOf":[{"type":"string","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_id","typeLabel":"string | null"},"client_secret":{"oneOf":[{"type":"string","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_secret.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_secret","typeLabel":"string | null"},"scopes":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.scopes.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.scopes","typeLabel":"string[] | null"},"redirect_uri":{"type":"string","title":"Redirect Uri","description":"Loopback redirect URI used to capture the authorization code.","default":"http://127.0.0.1:8765/callback","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.redirect_uri","typeLabel":"string"},"client_name":{"type":"string","title":"Client Name","description":"Client name sent during dynamic client registration.","default":"Swarms Agent","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_name","typeLabel":"string"},"client_uri":{"oneOf":[{"type":"string","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_uri.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_uri.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.client_uri","typeLabel":"string | null"},"authorization_url":{"oneOf":[{"type":"string","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.authorization_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.authorization_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.authorization_url","typeLabel":"string | null"},"token_url":{"oneOf":[{"type":"string","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.token_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.token_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.token_url","typeLabel":"string | null"},"access_token":{"oneOf":[{"type":"string","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.access_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.access_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.access_token","typeLabel":"string | null"},"refresh_token":{"oneOf":[{"type":"string","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.refresh_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.refresh_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.refresh_token","typeLabel":"string | null"},"token_storage_path":{"oneOf":[{"type":"string","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.token_storage_path.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.token_storage_path.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.token_storage_path","typeLabel":"string | null"},"use_token_cache":{"type":"boolean","title":"Use Token Cache","description":"Persist tokens to disk so the browser flow is only run once.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.use_token_cache","typeLabel":"boolean"},"open_browser":{"type":"boolean","title":"Open Browser","description":"Open the system browser for the authorization step. When False the URL is logged instead.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.open_browser","typeLabel":"boolean"},"callback_timeout":{"type":"integer","title":"Callback Timeout","description":"Seconds to wait for the user to complete the browser flow.","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0.callback_timeout","typeLabel":"integer"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.0","typeLabel":"MCPOAuthConfig · object"},{"type":"null","description":"OAuth 2.1 configuration for this server.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.oauth","typeLabel":"MCPOAuthConfig · object | null"},"transport":{"oneOf":[{"type":"string","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.transport.oneOf.0","typeLabel":"string"},{"type":"null","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.transport","typeLabel":"string | null"},"headers":{"oneOf":[{"type":"object","title":"Headers","description":"Headers to send to the MCP server","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.headers.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.headers.oneOf.0","typeLabel":"Headers · object"},{"type":"null","title":"Headers","description":"Headers to send to the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.headers","typeLabel":"Headers · object | null"},"timeout":{"oneOf":[{"type":"integer","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.timeout","typeLabel":"integer | null"},"sse_read_timeout":{"oneOf":[{"type":"integer","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.sse_read_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.sse_read_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.sse_read_timeout","typeLabel":"integer | null"},"tool_timeout":{"oneOf":[{"type":"integer","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.tool_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.tool_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.tool_timeout","typeLabel":"integer | null"},"command":{"oneOf":[{"type":"string","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.command.oneOf.0","typeLabel":"string"},{"type":"null","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.command.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.command","typeLabel":"string | null"},"args":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.args.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.args.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.args.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.args","typeLabel":"string[] | null"},"env":{"oneOf":[{"type":"object","title":"Env","description":"Environment variables for the 'stdio' command","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.env.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.env.oneOf.0","typeLabel":"Env · object"},{"type":"null","title":"Env","description":"Environment variables for the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.env.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1.env","typeLabel":"Env · object | null"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.1","typeLabel":"MCPConnection · object"},{"type":"object","title":"Mcp Url","description":"The MCP server the agent can use to complete its task. An https:// URL string for an unauthenticated server, or a connection object configuring auth and transport.","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.2","typeLabel":"Mcp Url · object"},{"type":"null","title":"Mcp Url","description":"The MCP server the agent can use to complete its task. An https:// URL string for an unauthenticated server, or a connection object configuring auth and transport.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url.oneOf.3","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_url","typeLabel":"string | MCPConnection · object | Mcp Url · object | null"},"streaming_on":{"oneOf":[{"type":"boolean","title":"Streaming On","description":"A flag indicating whether the agent should stream its output.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].streaming_on.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Streaming On","description":"A flag indicating whether the agent should stream its output.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].streaming_on.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].streaming_on","typeLabel":"boolean | null"},"llm_args":{"oneOf":[{"type":"object","title":"Llm Args","description":"Sampling arguments to pass to the LLM. Accepted keys: top_p, top_k, frequency_penalty, presence_penalty, stop, seed, logit_bias and response_format.","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].llm_args.oneOf.0","typeLabel":"Llm Args · object"},{"type":"null","title":"Llm Args","description":"Sampling arguments to pass to the LLM. Accepted keys: top_p, top_k, frequency_penalty, presence_penalty, stop, seed, logit_bias and response_format.","uniqueKey":"agents.oneOf.0.items.[INDEX].llm_args.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].llm_args","typeLabel":"Llm Args · object | null"},"top_p":{"oneOf":[{"type":"number","title":"Top P","description":"The top_p parameter to pass to the LLM.","uniqueKey":"agents.oneOf.0.items.[INDEX].top_p.oneOf.0","typeLabel":"number"},{"type":"null","title":"Top P","description":"The top_p parameter to pass to the LLM.","uniqueKey":"agents.oneOf.0.items.[INDEX].top_p.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].top_p","typeLabel":"number | null"},"dynamic_temperature_enabled":{"oneOf":[{"type":"boolean","title":"Dynamic Temperature Enabled","description":"A flag indicating whether the agent should dynamically adjust its temperature based on the task.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].dynamic_temperature_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Dynamic Temperature Enabled","description":"A flag indicating whether the agent should dynamically adjust its temperature based on the task.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].dynamic_temperature_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].dynamic_temperature_enabled","typeLabel":"boolean | null"},"mcp_config":{"oneOf":[{"type":"object","title":"MCPConnection","description":"The MCP connection to use for the agent.","properties":{"type":{"oneOf":[{"type":"string","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.type","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.name","typeLabel":"string | null"},"tool_configurations":{"oneOf":[{"type":"object","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.tool_configurations.oneOf.0","typeLabel":"Tool Configurations · object"},{"type":"null","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.tool_configurations.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.tool_configurations","typeLabel":"Tool Configurations · object | null"},"authorization_token":{"oneOf":[{"type":"string","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.authorization_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.authorization_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.authorization_token","typeLabel":"string | null"},"api_key":{"oneOf":[{"type":"string","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.api_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.api_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.api_key","typeLabel":"string | null"},"api_key_header":{"type":"string","title":"Api Key Header","description":"Header used to send the API key, e.g. 'Authorization' or 'X-API-Key'.","default":"Authorization","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.api_key_header","typeLabel":"string"},"api_key_prefix":{"oneOf":[{"type":"string","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.api_key_prefix.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.api_key_prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.api_key_prefix","typeLabel":"string | null"},"auth_type":{"oneOf":[{"type":"string","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","enum":["none","api_key","bearer","oauth","custom"],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.auth_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.auth_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.auth_type","typeLabel":"enum\u003cstring> | null"},"oauth":{"oneOf":[{"type":"object","title":"MCPOAuthConfig","description":"OAuth 2.1 configuration for this server.","properties":{"grant_type":{"type":"string","enum":["authorization_code","client_credentials"],"title":"Grant Type","description":"OAuth grant to use when no static access_token is supplied.","default":"authorization_code","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.grant_type","typeLabel":"enum\u003cstring>"},"client_id":{"oneOf":[{"type":"string","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_id","typeLabel":"string | null"},"client_secret":{"oneOf":[{"type":"string","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_secret.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_secret","typeLabel":"string | null"},"scopes":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.scopes.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.scopes","typeLabel":"string[] | null"},"redirect_uri":{"type":"string","title":"Redirect Uri","description":"Loopback redirect URI used to capture the authorization code.","default":"http://127.0.0.1:8765/callback","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.redirect_uri","typeLabel":"string"},"client_name":{"type":"string","title":"Client Name","description":"Client name sent during dynamic client registration.","default":"Swarms Agent","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_name","typeLabel":"string"},"client_uri":{"oneOf":[{"type":"string","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_uri.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_uri.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.client_uri","typeLabel":"string | null"},"authorization_url":{"oneOf":[{"type":"string","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.authorization_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.authorization_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.authorization_url","typeLabel":"string | null"},"token_url":{"oneOf":[{"type":"string","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.token_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.token_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.token_url","typeLabel":"string | null"},"access_token":{"oneOf":[{"type":"string","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.access_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.access_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.access_token","typeLabel":"string | null"},"refresh_token":{"oneOf":[{"type":"string","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.refresh_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.refresh_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.refresh_token","typeLabel":"string | null"},"token_storage_path":{"oneOf":[{"type":"string","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.token_storage_path.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.token_storage_path.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.token_storage_path","typeLabel":"string | null"},"use_token_cache":{"type":"boolean","title":"Use Token Cache","description":"Persist tokens to disk so the browser flow is only run once.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.use_token_cache","typeLabel":"boolean"},"open_browser":{"type":"boolean","title":"Open Browser","description":"Open the system browser for the authorization step. When False the URL is logged instead.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.open_browser","typeLabel":"boolean"},"callback_timeout":{"type":"integer","title":"Callback Timeout","description":"Seconds to wait for the user to complete the browser flow.","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0.callback_timeout","typeLabel":"integer"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.0","typeLabel":"MCPOAuthConfig · object"},{"type":"null","description":"OAuth 2.1 configuration for this server.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.oauth","typeLabel":"MCPOAuthConfig · object | null"},"transport":{"oneOf":[{"type":"string","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.transport.oneOf.0","typeLabel":"string"},{"type":"null","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.transport","typeLabel":"string | null"},"headers":{"oneOf":[{"type":"object","title":"Headers","description":"Headers to send to the MCP server","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.headers.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.headers.oneOf.0","typeLabel":"Headers · object"},{"type":"null","title":"Headers","description":"Headers to send to the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.headers","typeLabel":"Headers · object | null"},"timeout":{"oneOf":[{"type":"integer","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.timeout","typeLabel":"integer | null"},"sse_read_timeout":{"oneOf":[{"type":"integer","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.sse_read_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.sse_read_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.sse_read_timeout","typeLabel":"integer | null"},"tool_timeout":{"oneOf":[{"type":"integer","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.tool_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.tool_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.tool_timeout","typeLabel":"integer | null"},"command":{"oneOf":[{"type":"string","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.command.oneOf.0","typeLabel":"string"},{"type":"null","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.command.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.command","typeLabel":"string | null"},"args":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.args.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.args.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.args.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.args","typeLabel":"string[] | null"},"env":{"oneOf":[{"type":"object","title":"Env","description":"Environment variables for the 'stdio' command","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.env.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.env.oneOf.0","typeLabel":"Env · object"},{"type":"null","title":"Env","description":"Environment variables for the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.env.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0.env","typeLabel":"Env · object | null"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.0","typeLabel":"MCPConnection · object"},{"type":"object","title":"Mcp Config","description":"The MCP connection to use for the agent.","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.1","typeLabel":"Mcp Config · object"},{"type":"null","title":"Mcp Config","description":"The MCP connection to use for the agent.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config.oneOf.2","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_config","typeLabel":"MCPConnection · object | Mcp Config · object | null"},"mcp_configs":{"oneOf":[{"type":"array","items":{"oneOf":[{"type":"object","title":"MCPConnection","properties":{"type":{"oneOf":[{"type":"string","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.type","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.name","typeLabel":"string | null"},"tool_configurations":{"oneOf":[{"type":"object","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.tool_configurations.oneOf.0","typeLabel":"Tool Configurations · object"},{"type":"null","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.tool_configurations.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.tool_configurations","typeLabel":"Tool Configurations · object | null"},"authorization_token":{"oneOf":[{"type":"string","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.authorization_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.authorization_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.authorization_token","typeLabel":"string | null"},"api_key":{"oneOf":[{"type":"string","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.api_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.api_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.api_key","typeLabel":"string | null"},"api_key_header":{"type":"string","title":"Api Key Header","description":"Header used to send the API key, e.g. 'Authorization' or 'X-API-Key'.","default":"Authorization","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.api_key_header","typeLabel":"string"},"api_key_prefix":{"oneOf":[{"type":"string","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.api_key_prefix.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.api_key_prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.api_key_prefix","typeLabel":"string | null"},"auth_type":{"oneOf":[{"type":"string","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","enum":["none","api_key","bearer","oauth","custom"],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.auth_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.auth_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.auth_type","typeLabel":"enum\u003cstring> | null"},"oauth":{"oneOf":[{"type":"object","title":"MCPOAuthConfig","description":"OAuth 2.1 configuration for this server.","properties":{"grant_type":{"type":"string","enum":["authorization_code","client_credentials"],"title":"Grant Type","description":"OAuth grant to use when no static access_token is supplied.","default":"authorization_code","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.grant_type","typeLabel":"enum\u003cstring>"},"client_id":{"oneOf":[{"type":"string","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_id","typeLabel":"string | null"},"client_secret":{"oneOf":[{"type":"string","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_secret.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_secret","typeLabel":"string | null"},"scopes":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.scopes.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.scopes","typeLabel":"string[] | null"},"redirect_uri":{"type":"string","title":"Redirect Uri","description":"Loopback redirect URI used to capture the authorization code.","default":"http://127.0.0.1:8765/callback","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.redirect_uri","typeLabel":"string"},"client_name":{"type":"string","title":"Client Name","description":"Client name sent during dynamic client registration.","default":"Swarms Agent","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_name","typeLabel":"string"},"client_uri":{"oneOf":[{"type":"string","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_uri.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_uri.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.client_uri","typeLabel":"string | null"},"authorization_url":{"oneOf":[{"type":"string","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.authorization_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.authorization_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.authorization_url","typeLabel":"string | null"},"token_url":{"oneOf":[{"type":"string","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.token_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.token_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.token_url","typeLabel":"string | null"},"access_token":{"oneOf":[{"type":"string","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.access_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.access_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.access_token","typeLabel":"string | null"},"refresh_token":{"oneOf":[{"type":"string","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.refresh_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.refresh_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.refresh_token","typeLabel":"string | null"},"token_storage_path":{"oneOf":[{"type":"string","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.token_storage_path.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.token_storage_path.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.token_storage_path","typeLabel":"string | null"},"use_token_cache":{"type":"boolean","title":"Use Token Cache","description":"Persist tokens to disk so the browser flow is only run once.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.use_token_cache","typeLabel":"boolean"},"open_browser":{"type":"boolean","title":"Open Browser","description":"Open the system browser for the authorization step. When False the URL is logged instead.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.open_browser","typeLabel":"boolean"},"callback_timeout":{"type":"integer","title":"Callback Timeout","description":"Seconds to wait for the user to complete the browser flow.","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0.callback_timeout","typeLabel":"integer"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.0","typeLabel":"MCPOAuthConfig · object"},{"type":"null","description":"OAuth 2.1 configuration for this server.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.oauth","typeLabel":"MCPOAuthConfig · object | null"},"transport":{"oneOf":[{"type":"string","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.transport.oneOf.0","typeLabel":"string"},{"type":"null","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.transport","typeLabel":"string | null"},"headers":{"oneOf":[{"type":"object","title":"Headers","description":"Headers to send to the MCP server","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.headers.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.headers.oneOf.0","typeLabel":"Headers · object"},{"type":"null","title":"Headers","description":"Headers to send to the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.headers","typeLabel":"Headers · object | null"},"timeout":{"oneOf":[{"type":"integer","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.timeout","typeLabel":"integer | null"},"sse_read_timeout":{"oneOf":[{"type":"integer","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.sse_read_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.sse_read_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.sse_read_timeout","typeLabel":"integer | null"},"tool_timeout":{"oneOf":[{"type":"integer","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.tool_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.tool_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.tool_timeout","typeLabel":"integer | null"},"command":{"oneOf":[{"type":"string","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.command.oneOf.0","typeLabel":"string"},{"type":"null","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.command.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.command","typeLabel":"string | null"},"args":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.args.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.args.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.args.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.args","typeLabel":"string[] | null"},"env":{"oneOf":[{"type":"object","title":"Env","description":"Environment variables for the 'stdio' command","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.env.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.env.oneOf.0","typeLabel":"Env · object"},{"type":"null","title":"Env","description":"Environment variables for the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.env.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0.env","typeLabel":"Env · object | null"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"MCPConnection · object"},{"type":"object","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0.items.[INDEX]","typeLabel":"MCPConnection · object | object"},"title":"Mcp Configs","description":"The MCP connections to use for the agent. This is a list of MCP connections. Includes multiple MCP connections.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.0","typeLabel":"(MCPConnection · object | object)[]"},{"type":"null","title":"Mcp Configs","description":"The MCP connections to use for the agent. This is a list of MCP connections. Includes multiple MCP connections.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_configs","typeLabel":"(MCPConnection · object | object)[] | null"},"mcp_urls":{"oneOf":[{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","title":"MCPConnection","properties":{"type":{"oneOf":[{"type":"string","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Type","description":"The type of connection, defaults to 'mcp'","default":"mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.type","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Url","description":"The URL endpoint for the MCP server","default":"http://localhost:8000/mcp","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Human readable name for the server, used in logs and tool routing","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.name","typeLabel":"string | null"},"tool_configurations":{"oneOf":[{"type":"object","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.tool_configurations.oneOf.0","typeLabel":"Tool Configurations · object"},{"type":"null","title":"Tool Configurations","description":"Dictionary containing configuration settings for MCP tools","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.tool_configurations.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.tool_configurations","typeLabel":"Tool Configurations · object | null"},"authorization_token":{"oneOf":[{"type":"string","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.authorization_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Token","description":"Bearer token for accessing the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.authorization_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.authorization_token","typeLabel":"string | null"},"api_key":{"oneOf":[{"type":"string","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.api_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key","description":"API key for the MCP server. Sent using api_key_header/api_key_prefix.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.api_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.api_key","typeLabel":"string | null"},"api_key_header":{"type":"string","title":"Api Key Header","description":"Header used to send the API key, e.g. 'Authorization' or 'X-API-Key'.","default":"Authorization","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.api_key_header","typeLabel":"string"},"api_key_prefix":{"oneOf":[{"type":"string","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.api_key_prefix.oneOf.0","typeLabel":"string"},{"type":"null","title":"Api Key Prefix","description":"Prefix prepended to the API key value. Set to None/'' for raw keys.","default":"Bearer","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.api_key_prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.api_key_prefix","typeLabel":"string | null"},"auth_type":{"oneOf":[{"type":"string","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","enum":["none","api_key","bearer","oauth","custom"],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.auth_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Auth Type","description":"Explicit auth mode. Inferred from the other fields when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.auth_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.auth_type","typeLabel":"enum\u003cstring> | null"},"oauth":{"oneOf":[{"type":"object","title":"MCPOAuthConfig","description":"OAuth 2.1 configuration for this server.","properties":{"grant_type":{"type":"string","enum":["authorization_code","client_credentials"],"title":"Grant Type","description":"OAuth grant to use when no static access_token is supplied.","default":"authorization_code","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.grant_type","typeLabel":"enum\u003cstring>"},"client_id":{"oneOf":[{"type":"string","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Id","description":"OAuth client id. Optional for authorization_code when the server supports dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_id","typeLabel":"string | null"},"client_secret":{"oneOf":[{"type":"string","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_secret.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Secret","description":"OAuth client secret. Required for client_credentials.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_secret","typeLabel":"string | null"},"scopes":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.scopes.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Scopes","description":"Scopes to request, e.g. ['mcp:tools', 'offline_access'].","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.scopes","typeLabel":"string[] | null"},"redirect_uri":{"type":"string","title":"Redirect Uri","description":"Loopback redirect URI used to capture the authorization code.","default":"http://127.0.0.1:8765/callback","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.redirect_uri","typeLabel":"string"},"client_name":{"type":"string","title":"Client Name","description":"Client name sent during dynamic client registration.","default":"Swarms Agent","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_name","typeLabel":"string"},"client_uri":{"oneOf":[{"type":"string","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_uri.oneOf.0","typeLabel":"string"},{"type":"null","title":"Client Uri","description":"Client homepage sent during dynamic client registration.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_uri.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.client_uri","typeLabel":"string | null"},"authorization_url":{"oneOf":[{"type":"string","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.authorization_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Authorization Url","description":"Explicit authorization endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.authorization_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.authorization_url","typeLabel":"string | null"},"token_url":{"oneOf":[{"type":"string","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.token_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Url","description":"Explicit token endpoint. Discovered automatically when omitted.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.token_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.token_url","typeLabel":"string | null"},"access_token":{"oneOf":[{"type":"string","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.access_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Access Token","description":"Pre-obtained access token. When set, no OAuth flow is performed.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.access_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.access_token","typeLabel":"string | null"},"refresh_token":{"oneOf":[{"type":"string","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.refresh_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Refresh Token","description":"Pre-obtained refresh token, paired with access_token.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.refresh_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.refresh_token","typeLabel":"string | null"},"token_storage_path":{"oneOf":[{"type":"string","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.token_storage_path.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Storage Path","description":"File used to cache OAuth tokens. Defaults to ~/.swarms/mcp_auth/\u003cserver>.json.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.token_storage_path.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.token_storage_path","typeLabel":"string | null"},"use_token_cache":{"type":"boolean","title":"Use Token Cache","description":"Persist tokens to disk so the browser flow is only run once.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.use_token_cache","typeLabel":"boolean"},"open_browser":{"type":"boolean","title":"Open Browser","description":"Open the system browser for the authorization step. When False the URL is logged instead.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.open_browser","typeLabel":"boolean"},"callback_timeout":{"type":"integer","title":"Callback Timeout","description":"Seconds to wait for the user to complete the browser flow.","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0.callback_timeout","typeLabel":"integer"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.0","typeLabel":"MCPOAuthConfig · object"},{"type":"null","description":"OAuth 2.1 configuration for this server.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.oauth","typeLabel":"MCPOAuthConfig · object | null"},"transport":{"oneOf":[{"type":"string","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.transport.oneOf.0","typeLabel":"string"},{"type":"null","title":"Transport","description":"Transport protocol: 'streamable_http', 'sse', 'stdio', or 'auto'","default":"auto","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.transport.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.transport","typeLabel":"string | null"},"headers":{"oneOf":[{"type":"object","title":"Headers","description":"Headers to send to the MCP server","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.headers.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.headers.oneOf.0","typeLabel":"Headers · object"},{"type":"null","title":"Headers","description":"Headers to send to the MCP server","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.headers","typeLabel":"Headers · object | null"},"timeout":{"oneOf":[{"type":"integer","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Timeout","description":"Request timeout for the MCP server","default":30,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.timeout","typeLabel":"integer | null"},"sse_read_timeout":{"oneOf":[{"type":"integer","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.sse_read_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sse Read Timeout","description":"How long to wait for streamed events before giving up","default":300,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.sse_read_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.sse_read_timeout","typeLabel":"integer | null"},"tool_timeout":{"oneOf":[{"type":"integer","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.tool_timeout.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Tool Timeout","description":"How long a single tool call may run before timing out. Separate from `timeout`, which bounds HTTP requests.","default":120,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.tool_timeout.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.tool_timeout","typeLabel":"integer | null"},"command":{"oneOf":[{"type":"string","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.command.oneOf.0","typeLabel":"string"},{"type":"null","title":"Command","description":"Executable to launch for the 'stdio' transport","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.command.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.command","typeLabel":"string | null"},"args":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.args.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.args.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Args","description":"Arguments passed to the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.args.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.args","typeLabel":"string[] | null"},"env":{"oneOf":[{"type":"object","title":"Env","description":"Environment variables for the 'stdio' command","additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.env.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.env.oneOf.0","typeLabel":"Env · object"},{"type":"null","title":"Env","description":"Environment variables for the 'stdio' command","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.env.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1.env","typeLabel":"Env · object | null"}},"additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"MCPConnection · object"},{"type":"object","additionalProperties":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0.items.[INDEX]","typeLabel":"string | MCPConnection · object | object"},"title":"Mcp Urls","description":"Several MCP servers for the agent. Each entry is an https:// URL string for an unauthenticated server, or a connection object configuring auth and transport. Tools from every server are combined.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.0","typeLabel":"(string | MCPConnection · object | object)[]"},{"type":"null","title":"Mcp Urls","description":"Several MCP servers for the agent. Each entry is an https:// URL string for an unauthenticated server, or a connection object configuring auth and transport. Tools from every server are combined.","uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].mcp_urls","typeLabel":"(string | MCPConnection · object | object)[] | null"},"tool_call_summary":{"oneOf":[{"type":"boolean","title":"Tool Call Summary","description":"A parameter enabling an agent to summarize tool calls.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].tool_call_summary.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Tool Call Summary","description":"A parameter enabling an agent to summarize tool calls.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].tool_call_summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].tool_call_summary","typeLabel":"boolean | null"},"reasoning_effort":{"oneOf":[{"type":"string","title":"Reasoning Effort","description":"How much effort the agent puts into reasoning. Accepted values, tracking the reasoning levels the installed litellm advertises: 'minimal', 'low', 'medium', 'high', 'none', 'xhigh', 'ultra', 'max', 'None'. 'max' is the top tier (deepest reasoning) and no beta header is required. At 'xhigh' and above, pair with a large max_tokens so the model has room to think and answer.","enum":["minimal","low","medium","high","none","xhigh","ultra","max","None"],"uniqueKey":"agents.oneOf.0.items.[INDEX].reasoning_effort.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Reasoning Effort","description":"How much effort the agent puts into reasoning. Accepted values, tracking the reasoning levels the installed litellm advertises: 'minimal', 'low', 'medium', 'high', 'none', 'xhigh', 'ultra', 'max', 'None'. 'max' is the top tier (deepest reasoning) and no beta header is required. At 'xhigh' and above, pair with a large max_tokens so the model has room to think and answer.","uniqueKey":"agents.oneOf.0.items.[INDEX].reasoning_effort.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].reasoning_effort","typeLabel":"enum\u003cstring> | null"},"thinking_tokens":{"oneOf":[{"type":"integer","title":"Thinking Tokens","description":"The number of tokens to use for thinking.","uniqueKey":"agents.oneOf.0.items.[INDEX].thinking_tokens.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Thinking Tokens","description":"The number of tokens to use for thinking.","uniqueKey":"agents.oneOf.0.items.[INDEX].thinking_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].thinking_tokens","typeLabel":"integer | null"},"reasoning_enabled":{"oneOf":[{"type":"boolean","title":"Reasoning Enabled","description":"A parameter enabling an agent to use reasoning.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].reasoning_enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Reasoning Enabled","description":"A parameter enabling an agent to use reasoning.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].reasoning_enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].reasoning_enabled","typeLabel":"boolean | null"},"publish_to_marketplace":{"oneOf":[{"type":"boolean","title":"Publish To Marketplace","description":"A flag indicating whether to publish this agent to the Swarms marketplace, under the account of the API key that sent the request.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].publish_to_marketplace.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Publish To Marketplace","description":"A flag indicating whether to publish this agent to the Swarms marketplace, under the account of the API key that sent the request.","default":false,"uniqueKey":"agents.oneOf.0.items.[INDEX].publish_to_marketplace.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].publish_to_marketplace","typeLabel":"boolean | null"},"use_cases":{"oneOf":[{"type":"array","items":{"additionalProperties":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].use_cases.oneOf.0.items.[INDEX].additionalProperties","typeLabel":"string"},"type":"object","uniqueKey":"agents.oneOf.0.items.[INDEX].use_cases.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Use Cases","description":"A list of use case dictionaries with 'title' and 'description' keys, shown on the marketplace listing. Optional, including when publish_to_marketplace is True.","uniqueKey":"agents.oneOf.0.items.[INDEX].use_cases.oneOf.0","typeLabel":"Use Cases · object[]"},{"type":"null","title":"Use Cases","description":"A list of use case dictionaries with 'title' and 'description' keys, shown on the marketplace listing. Optional, including when publish_to_marketplace is True.","uniqueKey":"agents.oneOf.0.items.[INDEX].use_cases.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].use_cases","typeLabel":"Use Cases · object[] | null"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Tags","description":"A list of searchable tags/keywords for the marketplace (e.g., ['finance', 'analysis']).","uniqueKey":"agents.oneOf.0.items.[INDEX].tags.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Tags","description":"A list of searchable tags/keywords for the marketplace (e.g., ['finance', 'analysis']).","uniqueKey":"agents.oneOf.0.items.[INDEX].tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].tags","typeLabel":"string[] | null"},"capabilities":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"agents.oneOf.0.items.[INDEX].capabilities.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Capabilities","description":"A list of agent capabilities or features (e.g., ['trend-analysis', 'risk-assessment']).","uniqueKey":"agents.oneOf.0.items.[INDEX].capabilities.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Capabilities","description":"A list of agent capabilities or features (e.g., ['trend-analysis', 'risk-assessment']).","uniqueKey":"agents.oneOf.0.items.[INDEX].capabilities.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].capabilities","typeLabel":"string[] | null"},"category":{"oneOf":[{"type":"string","title":"Category","description":"The marketplace category for the agent (e.g., 'research', 'content', 'coding', 'finance', 'healthcare', 'education', 'legal').","uniqueKey":"agents.oneOf.0.items.[INDEX].category.oneOf.0","typeLabel":"string"},{"type":"null","title":"Category","description":"The marketplace category for the agent (e.g., 'research', 'content', 'coding', 'finance', 'healthcare', 'education', 'legal').","uniqueKey":"agents.oneOf.0.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].category","typeLabel":"string | null"},"is_free":{"oneOf":[{"type":"boolean","title":"Is Free","description":"A flag indicating whether the agent is free to use in the marketplace.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].is_free.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Free","description":"A flag indicating whether the agent is free to use in the marketplace.","default":true,"uniqueKey":"agents.oneOf.0.items.[INDEX].is_free.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].is_free","typeLabel":"boolean | null"},"price_usd":{"oneOf":[{"type":"number","title":"Price Usd","description":"The price in USD for using this agent in the marketplace (if not free).","uniqueKey":"agents.oneOf.0.items.[INDEX].price_usd.oneOf.0","typeLabel":"number"},{"type":"null","title":"Price Usd","description":"The price in USD for using this agent in the marketplace (if not free).","uniqueKey":"agents.oneOf.0.items.[INDEX].price_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].price_usd","typeLabel":"number | null"},"handoffs":{"oneOf":[{"type":"array","items":{"oneOf":[{}],"uniqueKey":"agents.oneOf.0.items.[INDEX].handoffs.oneOf.0.items.[INDEX]","typeLabel":"any"},"title":"Handoffs","description":"A list of agent specifications that this agent can hand off tasks to. These agents will be created and passed to the agent's handoffs parameter. At most 2000 agents in total, counting the handoffs of each handoff.","maxItems":2000,"uniqueKey":"agents.oneOf.0.items.[INDEX].handoffs.oneOf.0","typeLabel":"any[]"},{"type":"null","title":"Handoffs","description":"A list of agent specifications that this agent can hand off tasks to. These agents will be created and passed to the agent's handoffs parameter. At most 2000 agents in total, counting the handoffs of each handoff.","uniqueKey":"agents.oneOf.0.items.[INDEX].handoffs.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents.oneOf.0.items.[INDEX].handoffs","typeLabel":"any[] | null"}},"type":"object","title":"AgentSpec","description":"The configuration of the agent to be completed.","uniqueKey":"agents.oneOf.0.items.[INDEX]","typeLabel":"AgentSpec · object"},"title":"Agents","description":"List of agent specifications to be used as nodes in the workflow graph. At most 2000.","maxItems":2000,"uniqueKey":"agents.oneOf.0","typeLabel":"AgentSpec · object[]"},{"type":"null","title":"Agents","description":"List of agent specifications to be used as nodes in the workflow graph. At most 2000.","uniqueKey":"agents.oneOf.1","typeLabel":"null"}],"uniqueKey":"agents","typeLabel":"AgentSpec · object[] | null"},"edges":{"oneOf":[{"type":"array","items":{"oneOf":[{"type":"object","title":"EdgeSpec","description":"Schema for defining an edge between nodes in the workflow graph.","required":["source","target"],"properties":{"source":{"type":"string","title":"Source","description":"The source node ID.","isRequired":true,"uniqueKey":"edges.oneOf.0.items.[INDEX].oneOf.0.source","typeLabel":"string"},"target":{"type":"string","title":"Target","description":"The target node ID.","isRequired":true,"uniqueKey":"edges.oneOf.0.items.[INDEX].oneOf.0.target","typeLabel":"string"},"metadata":{"oneOf":[{"type":"object","title":"Metadata","description":"Optional metadata for the edge.","additionalProperties":true,"uniqueKey":"edges.oneOf.0.items.[INDEX].oneOf.0.metadata.oneOf.0","typeLabel":"Metadata · object"},{"type":"null","title":"Metadata","description":"Optional metadata for the edge.","uniqueKey":"edges.oneOf.0.items.[INDEX].oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"edges.oneOf.0.items.[INDEX].oneOf.0.metadata","typeLabel":"Metadata · object | null"}},"uniqueKey":"edges.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"EdgeSpec · object"},{"type":"object","additionalProperties":true,"uniqueKey":"edges.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"edges.oneOf.0.items.[INDEX]","typeLabel":"EdgeSpec · object | object"},"title":"Edges","description":"List of edges connecting nodes. Can be EdgeSpec objects or dictionaries with 'source' and 'target' keys. The edges must not form a cycle: a cyclic graph returns 400.","uniqueKey":"edges.oneOf.0","typeLabel":"(EdgeSpec · object | object)[]"},{"type":"null","title":"Edges","description":"List of edges connecting nodes. Can be EdgeSpec objects or dictionaries with 'source' and 'target' keys. The edges must not form a cycle: a cyclic graph returns 400.","uniqueKey":"edges.oneOf.1","typeLabel":"null"}],"uniqueKey":"edges","typeLabel":"(EdgeSpec · object | object)[] | null"},"entry_points":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"entry_points.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Entry Points","description":"List of node IDs that serve as starting points for the workflow.","uniqueKey":"entry_points.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Entry Points","description":"List of node IDs that serve as starting points for the workflow.","uniqueKey":"entry_points.oneOf.1","typeLabel":"null"}],"uniqueKey":"entry_points","typeLabel":"string[] | null"},"end_points":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"end_points.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"End Points","description":"List of node IDs that serve as ending points for the workflow.","uniqueKey":"end_points.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"End Points","description":"List of node IDs that serve as ending points for the workflow.","uniqueKey":"end_points.oneOf.1","typeLabel":"null"}],"uniqueKey":"end_points","typeLabel":"string[] | null"},"max_loops":{"oneOf":[{"type":"integer","title":"Max Loops","description":"The maximum number of execution loops for the workflow.","default":1,"uniqueKey":"max_loops.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Loops","description":"The maximum number of execution loops for the workflow.","default":1,"uniqueKey":"max_loops.oneOf.1","typeLabel":"null"}],"uniqueKey":"max_loops","typeLabel":"integer | null"},"task":{"oneOf":[{"type":"string","title":"Task","description":"The task to be executed by the workflow. Required: a missing or blank task returns 400.","uniqueKey":"task.oneOf.0","typeLabel":"string"},{"type":"null","title":"Task","description":"The task to be executed by the workflow. Required: a missing or blank task returns 400.","uniqueKey":"task.oneOf.1","typeLabel":"null"}],"uniqueKey":"task","typeLabel":"string | null"},"img":{"oneOf":[{"type":"string","title":"Img","description":"Optional https:// image URL or base64 encoded image for vision-enabled agents.","uniqueKey":"img.oneOf.0","typeLabel":"string"},{"type":"null","title":"Img","description":"Optional https:// image URL or base64 encoded image for vision-enabled agents.","uniqueKey":"img.oneOf.1","typeLabel":"null"}],"uniqueKey":"img","typeLabel":"string | null"},"auto_compile":{"oneOf":[{"type":"boolean","title":"Auto Compile","description":"Whether to automatically compile the workflow for optimization.","default":true,"uniqueKey":"auto_compile.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Auto Compile","description":"Whether to automatically compile the workflow for optimization.","default":true,"uniqueKey":"auto_compile.oneOf.1","typeLabel":"null"}],"uniqueKey":"auto_compile","typeLabel":"boolean | null"},"verbose":{"oneOf":[{"type":"boolean","title":"Verbose","description":"Whether to enable detailed logging.","default":false,"uniqueKey":"verbose.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Verbose","description":"Whether to enable detailed logging.","default":false,"uniqueKey":"verbose.oneOf.1","typeLabel":"null"}],"uniqueKey":"verbose","typeLabel":"boolean | null"}},"type":"object","title":"GraphWorkflowInput","description":"Input schema for GraphWorkflow completion requests.","uniqueKey":"","typeLabel":"GraphWorkflowInput · object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","description":"\u003cstring>","agents":[{"agent_name":"\u003cstring>","description":"\u003cstring>","system_prompt":"\u003cstring>","marketplace_prompt_id":"\u003cstring>","model_name":"claude-sonnet-5","fallback_models":["\u003cstring>"],"fallback_model_name":"\u003cstring>","auto_generate_prompt":false,"max_tokens":16000,"temperature":1,"role":"worker","max_loops":1,"tools_list_dictionary":[{}],"selected_tools":"\u003cstring>","mcp_url":"\u003cstring>","streaming_on":false,"llm_args":{},"top_p":123,"dynamic_temperature_enabled":false,"mcp_config":{"type":"mcp","url":"http://localhost:8000/mcp","name":"\u003cstring>","tool_configurations":{},"authorization_token":"\u003cstring>","api_key":"\u003cstring>","api_key_header":"Authorization","api_key_prefix":"Bearer","oauth":{"grant_type":"authorization_code","client_id":"\u003cstring>","client_secret":"\u003cstring>","scopes":["\u003cstring>"],"redirect_uri":"http://127.0.0.1:8765/callback","client_name":"Swarms Agent","client_uri":"\u003cstring>","authorization_url":"\u003cstring>","token_url":"\u003cstring>","access_token":"\u003cstring>","refresh_token":"\u003cstring>","token_storage_path":"\u003cstring>","use_token_cache":true,"open_browser":true,"callback_timeout":300},"transport":"auto","headers":{},"timeout":30,"sse_read_timeout":300,"tool_timeout":120,"command":"\u003cstring>","args":["\u003cstring>"],"env":{}},"mcp_configs":[{"type":"mcp","url":"http://localhost:8000/mcp","name":"\u003cstring>","tool_configurations":{},"authorization_token":"\u003cstring>","api_key":"\u003cstring>","api_key_header":"Authorization","api_key_prefix":"Bearer","oauth":{"grant_type":"authorization_code","client_id":"\u003cstring>","client_secret":"\u003cstring>","scopes":["\u003cstring>"],"redirect_uri":"http://127.0.0.1:8765/callback","client_name":"Swarms Agent","client_uri":"\u003cstring>","authorization_url":"\u003cstring>","token_url":"\u003cstring>","access_token":"\u003cstring>","refresh_token":"\u003cstring>","token_storage_path":"\u003cstring>","use_token_cache":true,"open_browser":true,"callback_timeout":300},"transport":"auto","headers":{},"timeout":30,"sse_read_timeout":300,"tool_timeout":120,"command":"\u003cstring>","args":["\u003cstring>"],"env":{}}],"mcp_urls":["\u003cstring>"],"tool_call_summary":true,"thinking_tokens":123,"reasoning_enabled":false,"publish_to_marketplace":false,"use_cases":[{}],"tags":["\u003cstring>"],"capabilities":["\u003cstring>"],"category":"\u003cstring>","is_free":true,"price_usd":123,"handoffs":["\u003cunknown>"]}],"edges":[{"source":"\u003cstring>","target":"\u003cstring>","metadata":{}}],"entry_points":["\u003cstring>"],"end_points":["\u003cstring>"],"max_loops":1,"task":"\u003cstring>","img":"\u003cstring>","auto_compile":true,"verbose":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"44d47000-c3ff-4cb2-bb3f-b618b6817de6":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"The job ID of the graph workflow.","isRequired":true,"uniqueKey":"job_id","typeLabel":"string"},"status":{"type":"string","title":"Status","description":"The status of the graph workflow.","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"outputs":{"title":"Outputs","description":"The outputs of the graph workflow.","isRequired":true,"uniqueKey":"outputs","typeLabel":"any"},"usage":{"properties":{"input_tokens":{"type":"integer","title":"Input Tokens","description":"The number of input tokens.","isRequired":true,"uniqueKey":"usage.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","title":"Output Tokens","description":"The number of output tokens.","isRequired":true,"uniqueKey":"usage.output_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","title":"Total Tokens","description":"The total number of tokens.","isRequired":true,"uniqueKey":"usage.total_tokens","typeLabel":"integer"},"total_cost":{"type":"number","title":"Total Cost","description":"The cost in credits for the tokens.","isRequired":true,"uniqueKey":"usage.total_cost","typeLabel":"number"},"cost_per_agent":{"type":"number","title":"Cost Per Agent","description":"The cost in credits for the agents.","default":0.01,"uniqueKey":"usage.cost_per_agent","typeLabel":"number"},"flash_sale_applied":{"type":"boolean","title":"Flash Sale Applied","description":"Whether the tokens were billed at the flash sale price.","default":false,"uniqueKey":"usage.flash_sale_applied","typeLabel":"boolean"}},"type":"object","required":["input_tokens","output_tokens","total_tokens","total_cost"],"title":"Usage","description":"The usage statistics of the workflow.","isRequired":true,"uniqueKey":"usage","typeLabel":"Usage · object"},"timestamp":{"type":"string","title":"Timestamp","description":"The timestamp of the graph workflow execution.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string"},"name":{"oneOf":[{"type":"string","title":"Name","description":"The name of the graph workflow.","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"The name of the graph workflow.","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","title":"Description","description":"The description of the graph workflow.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"The description of the graph workflow.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"}},"type":"object","required":["job_id","status","outputs","usage","timestamp"],"title":"GraphWorkflowOutput","description":"Output schema for GraphWorkflow completion responses.","uniqueKey":"","typeLabel":"GraphWorkflowOutput · object"},"examples":{"Example":{"title":"Example","value":{"job_id":"\u003cstring>","status":"\u003cstring>","outputs":"\u003cunknown>","usage":{"input_tokens":123,"output_tokens":123,"total_tokens":123,"total_cost":123,"cost_per_agent":0.01,"flash_sale_applied":false},"timestamp":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cf2b45f3-172e-4cd6-883c-fa74e38ff178":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"c2dfd685-4751-40be-ab07-129d372d97a4":{"url":"https://api.swarms.world","description":"Swarms Production API"}}},"originalFileLocation":"https://api.swarms.world/openapi.json"},"subdomain":"swarms","siteName":"Swarms API Documentation","title":"Swarms API Documentation - Build AI Agents \u0026 Multi-Agent Systems","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T18:42:32.327Z","originalFileLocation":"api-reference/graph-workflow/execute-graph-workflow.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Swarms API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/swarms/XE756JttG-8ikCCA/_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/swarms/XE756JttG-8ikCCA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/swarms/XE756JttG-8ikCCA/_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/swarms/XE756JttG-8ikCCA/_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/swarms/XE756JttG-8ikCCA/_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/swarms/XE756JttG-8ikCCA/_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/swarms/XE756JttG-8ikCCA/_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/swarms/XE756JttG-8ikCCA/_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/swarms/XE756JttG-8ikCCA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Swarms API Documentation - Build AI Agents \u0026amp; Multi-Agent Systems\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create intelligent AI agents and multi-agent swarms with the Swarms API. Support for OpenAI, Anthropic, and Groq models with enterprise-scale orchestration.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Swarms API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.swarms.ai/bg.jpg\">\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=\"Swarms API Documentation - Build AI Agents \u0026amp; Multi-Agent Swarms\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create intelligent AI agents and multi-agent swarms with the Swarms API. Support for OpenAI, Anthropic, and Groq models.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.swarms.ai/bg.jpg\">\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/swarms/XE756JttG-8ikCCA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Swarms API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DC2626\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"charset\" content=\"UTF-8\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\">\u003cmeta data-mint-head name=\"google\" content=\"notranslate\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#DC2626\">\u003cmeta data-mint-head name=\"color-scheme\" content=\"light dark\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"referrer\" content=\"strict-origin-when-cross-origin\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"copyright\" content=\"Copyright 2024 The Swarm Corporation\">\u003cmeta data-mint-head name=\"distribution\" content=\"global\">\u003cmeta data-mint-head name=\"coverage\" content=\"Worldwide\">\u003cmeta data-mint-head name=\"category\" content=\"Technology\">\u003cmeta data-mint-head name=\"target\" content=\"all\">\u003cmeta data-mint-head name=\"rating\" content=\"general\">\u003cmeta data-mint-head name=\"revisit-after\" content=\"3 days\">\u003cmeta data-mint-head name=\"HandheldFriendly\" content=\"True\">\u003cmeta data-mint-head name=\"MobileOptimized\" content=\"320\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-capable\" content=\"yes\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-status-bar-style\" content=\"black-translucent\">\u003cmeta data-mint-head name=\"application-name\" content=\"Swarms API Documentation\">\u003cmeta data-mint-head name=\"msapplication-navbutton-color\" content=\"#DC2626\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Swarms API Documentation - Build intelligent AI agents and multi-agent swarms\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@kyegomez\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"Swarms API Documentation - Build intelligent AI agents and multi-agent swarms\">\u003cmeta data-mint-head name=\"article:author\" content=\"The Swarm Corporation\">\u003cmeta data-mint-head name=\"article:section\" content=\"Technology\">\u003cmeta data-mint-head name=\"article:tag\" content=\"AI agents, multi-agent systems, swarm intelligence, API documentation, artificial intelligence\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/graph-workflow/execute-graph-workflow.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.swarms.ai/#organization\",\"name\":\"Swarms API Documentation\",\"url\":\"https://docs.swarms.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/swarms/0uhx6ZFxLaCyzbhr/logo/light.svg?fit=max\u0026auto=format\u0026n=0uhx6ZFxLaCyzbhr\u0026q=85\u0026s=0c5b6851cc5173c655702a17160d54c5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.swarms.ai#website\",\"name\":\"Swarms API Documentation\",\"url\":\"https://docs.swarms.ai\",\"publisher\":{\"@id\":\"https://docs.swarms.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow#webpage\",\"url\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow\",\"name\":\"Execute Graph Workflow\",\"description\":\"Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.\",\"dateModified\":\"2026-11-17T18:42:32.327Z\",\"isPartOf\":{\"@id\":\"https://docs.swarms.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Swarms API Documentation\",\"item\":\"https://docs.swarms.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Execute Graph Workflow\",\"item\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow#apireference\",\"headline\":\"Execute Graph Workflow\",\"name\":\"Execute Graph Workflow\",\"description\":\"Execute a graph workflow with directed agent nodes and edges. Enables complex multi-agent collaboration with parallel execution, automatic compilation, and comprehensive workflow orchestration.\",\"url\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow\",\"mainEntityOfPage\":{\"@id\":\"https://docs.swarms.ai/api-reference/graph-workflow/execute-graph-workflow#webpage\"},\"image\":\"https://docs.swarms.ai/bg.jpg\",\"dateModified\":\"2026-11-17T18:42:32.327Z\",\"publisher\":{\"@id\":\"https://docs.swarms.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.swarms.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Swarms API Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Swarms API Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/graph-workflow/execute-graph-workflow.md","siteName":"Swarms API Documentation","nav":{"global":{"anchors":[{"anchor":"Get Your API Key","href":"https://swarms.world/platform/api-keys"},{"anchor":"Account Management","href":"https://swarms.world/platform/account"},{"anchor":"Discord","href":"https://discord.gg/EamjgSaEQf"},{"anchor":"Technical Support","href":"https://cal.com/swarms/swarms-technical-support?overlayCalendar=true"}]},"tabs":[{"tab":"Introduction","pages":[{"title":"Introduction","href":"/docs/introduction/overview"}]},{"tab":"Swarms API","pages":[{"title":"Swarms API","href":"/docs/documentation"}]},{"tab":"Marketplace","pages":[{"title":"Marketplace","href":"/docs/marketplace"}]},{"tab":"API Reference","groups":[{"group":"General","pages":[{"title":"API Root","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /","href":"/api-reference/general/api-root"},{"title":"Health Check","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /health","href":"/api-reference/general/health-check"}]},{"group":"Swarms","pages":[{"title":"Get Available Swarm Types","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/swarms/available","href":"/api-reference/swarms/get-available-swarm-types"},{"title":"Execute Swarm Completion","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/swarm/completions","href":"/api-reference/swarms/execute-swarm-completion"},{"title":"Execute Batch Swarm Completions","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/swarm/batch/completions","href":"/api-reference/swarms/execute-batch-swarm-completions"}]},{"group":"Account Management","pages":[{"title":"Get Premium Endpoints","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/account/premium-endpoints","href":"/api-reference/account-management/get-premium-endpoints"},{"title":"Get API Request Logs","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/account/logs","href":"/api-reference/account-management/get-api-request-logs"},{"title":"Get User Metrics Summary","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/account/metrics/summary","href":"/api-reference/account-management/get-user-metrics-summary"},{"title":"Credit Balance","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/account/credits","href":"/api-reference/account-management/credit-balance"}]},{"group":"Anthropic Compatible","pages":[{"title":"Messages (Anthropic-compatible)","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/messages","href":"/api-reference/anthropic-compatible/messages-anthropic-compatible"}]},{"group":"OpenAI Compatible","pages":[{"title":"Chat Completions (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/chat/completions","href":"/api-reference/openai-compatible/chat-completions-openai-compatible"},{"title":"Create a response (OpenAI-compatible, non-streaming)","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/responses","href":"/api-reference/openai-compatible/create-a-response-openai-compatible-non-streaming"}]},{"group":"Agents","pages":[{"title":"Execute Agent Completion","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/agent/completions","href":"/api-reference/agents/execute-agent-completion"},{"title":"Execute Batch Agent Completions","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/agent/batch/completions","href":"/api-reference/agents/execute-batch-agent-completions"},{"title":"List Agent Configurations","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/agents/list","href":"/api-reference/agents/list-agent-configurations"}]},{"group":"Reasoning Agents","pages":[{"title":"Execute Reasoning Agent Completion","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/reasoning-agent/completions","href":"/api-reference/reasoning-agents/execute-reasoning-agent-completion"},{"title":"Get Reasoning Agent Types","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/reasoning-agent/types","href":"/api-reference/reasoning-agents/get-reasoning-agent-types"}]},{"group":"Decision Models","pages":[{"title":"Execute Decision Model Completion","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/decision/completions","href":"/api-reference/decision-models/execute-decision-model-completion"},{"title":"Execute Decision Model Completion (TypeSafe API)","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/systemone","href":"/api-reference/decision-models/execute-decision-model-completion-typesafe-api"},{"title":"Get Decision Models and Prices","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/decision/models","href":"/api-reference/decision-models/get-decision-models-and-prices"}]},{"group":"Logging","pages":[{"title":"Get API Request Logs (deprecated path)","deprecated":true,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/swarm/logs","href":"/api-reference/logging/get-api-request-logs-deprecated-path"},{"title":"Get a Completion by Job ID","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/job/{job_id}","href":"/api-reference/logging/get-a-completion-by-job-id"}]},{"group":"Metrics","pages":[{"title":"Get User Metrics Summary (deprecated path)","deprecated":true,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/metrics/summary","href":"/api-reference/metrics/get-user-metrics-summary-deprecated-path"}]},{"group":"Models","pages":[{"title":"List Models (OpenAI-Compatible)","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/models","href":"/api-reference/models/list-models-openai-compatible"},{"title":"Get Available AI Models","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/models/available","href":"/api-reference/models/get-available-ai-models"},{"title":"Get Model Pricing","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/models/pricing","href":"/api-reference/models/get-model-pricing"}]},{"group":"Rate Limiting","pages":[{"title":"Get Rate Limits and Usage","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/rate/limits","href":"/api-reference/rate-limiting/get-rate-limits-and-usage"}]},{"group":"Tool Management","pages":[{"title":"Get Available API Tools","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/tools/available","href":"/api-reference/tool-management/get-available-api-tools"}]},{"group":"Batched Grid Workflow","pages":[{"title":"Execute Batched Grid Workflow","description":"Execute a batched grid workflow enabling parallel execution of multiple agents across multiple tasks in a single request. This is a premium-only feature.","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/batched-grid-workflow/completions","href":"/api-reference/batched-grid-workflow/execute-batched-grid-workflow"}]},{"group":"Graph Workflow","pages":[{"title":"Execute Graph Workflow","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/graph-workflow/completions","href":"/api-reference/graph-workflow/execute-graph-workflow"}]},{"group":"Auto Agent Builder","pages":[{"title":"Generate Agent Configurations From a Task","description":"Generate a roster of agent configurations for a task. A single builder agent designs the team and returns ready-to-post AgentSpec entries — the generated agents are not executed by this endpoint.","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json post /v1/auto-agent-builder/completions","href":"/api-reference/auto-agent-builder/generate-agent-configurations-from-a-task"}]},{"group":"Pricing","pages":[{"title":"Get Comprehensive Pricing Details","deprecated":null,"version":null,"openapi":"https://api.swarms.world/openapi.json get /v1/usage/costs","href":"/api-reference/pricing/get-comprehensive-pricing-details"}]}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/docs/examples/examples/client-setup"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/docs/documentation/changelog"}]}]},"basePath":"","title":"Swarms API Documentation - Build AI Agents \u0026 Multi-Agent Systems","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"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","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.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"]}