External user (end user) to act as. Optional — if omitted, Flowra uses the project’s default external user. Send a stable username (e.g. customer_alice) only when you need another end-user context.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Flowra","description":"Build AI agents and workflows in chat, then integrate with the Flowra API, MCP, and embeds.","colors":{"primary":"#bb7400","light":"#e8b04a","dark":"#bb7400"},"logo":{"light":"https://mintcdn.com/flowra/KoDiEtrvqx_MHDGG/logo/light-with-text.svg?fit=max\u0026auto=format\u0026n=KoDiEtrvqx_MHDGG\u0026q=85\u0026s=07e27ae1fc4dcde969fed24cc2af1a7f","dark":"https://mintcdn.com/flowra/KoDiEtrvqx_MHDGG/logo/dark-with-text.svg?fit=max\u0026auto=format\u0026n=KoDiEtrvqx_MHDGG\u0026q=85\u0026s=becfcfab769f5d921b434cff0d5d0793"},"favicon":"https://mintcdn.com/flowra/r26XWHG32RWMAlq0/favicon.svg?fit=max\u0026auto=format\u0026n=r26XWHG32RWMAlq0\u0026q=85\u0026s=54b453ad5bb244866ae818d688e57bb2","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[{"href":"mailto:support@flowra.dev","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://flowra.dev/dashboard"}},"footer":{"socials":{"github":"https://github.com/flowradev/sdk","x":"https://x.com/flowradev"}},"seo":{"metatags":{"canonical":"https://docs.flowra.dev"},"organization":{"name":"Flowra","url":"https://flowra.dev","logo":"https://docs.flowra.dev/logo/light-with-text.svg","sameAs":["https://github.com/flowradev/sdk","https://x.com/flowradev"]},"indexing":"all"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"rectangle-terminal","href":"https://flowra.dev/dashboard"},{"anchor":"API","icon":"code","href":"/api-reference"},{"anchor":"SDK","icon":"cube","href":"/guides/sdk"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"flowra","hasAudioNarration":false,"actualSubdomain":"flowra","customDomains":["docs.flowra.dev"],"gitSource":{"type":"github","owner":"flowradev","repo":"flowra-doc","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6acb40a7b9968432185f8788","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API reference","count":147},{"language":"default","tag":"Developers","count":40},{"language":"default","tag":"Product","count":24},{"language":"default","tag":"Workflow \u0026 Agent","count":18},{"language":"default","tag":"In the dashboard","count":16},{"language":"default","tag":"Chat","count":14},{"language":"default","tag":"MCP","count":14},{"language":"default","tag":"Knowledge","count":13},{"language":"default","tag":"Skills","count":12},{"language":"default","tag":"Getting started","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/workflow-\u0026-agent/create-workflow-agent","slug":"/api-reference/workflow-\u0026-agent/create-workflow-agent","pageMetadata":{"title":"Create workflow (agent)","description":"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/workflow/manager/create","href":"/api-reference/workflow-\u0026-agent/create-workflow-agent","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create workflow (agent)","description":"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/workflow/manager/create","href":"/api-reference/workflow-\u0026-agent/create-workflow-agent","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"WorkflowManagerController_create","x-apiKeyEnabled":true,"summary":"Create workflow (agent)","description":"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.","parameters":["0666f98f-a716-4b96-8326-0496c37b14f9"],"requestBody":"442e4fab-d2b5-46e9-9f3b-a63d5819274b","responses":{"200":"fc6065d9-1001-4a5f-a852-55c48d6ced8e"},"tags":["Workflow \u0026 Agent"],"security":["62185a36-a6c8-4d4f-bd7b-7438606ebe65","8a588f89-f0a7-4303-bc14-79a23bad2e3f"],"method":"post","type":"path","servers":["7d552b2e-a0a4-4310-b6db-55864d1e3c57"],"path":"/api/v1/workflow/manager/create","baseUrlOptions":["https://flowra.dev"],"title":"Create workflow (agent)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0666f98f-a716-4b96-8326-0496c37b14f9":{"name":"x-username","in":"header","required":false,"description":"External user (end user) to act as. Optional — if omitted, Flowra uses the project’s default external user. Send a stable username (e.g. customer_alice) only when you need another end-user context.","schema":{"type":"string","default":"(project default user)","isRequired":false,"description":"External user (end user) to act as. Optional — if omitted, Flowra uses the project’s default external user. Send a stable username (e.g. customer_alice) only when you need another end-user context.","uniqueKey":"","typeLabel":"string"},"example":"customer_alice"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Agent name","default":"New Agent","example":"Support bot","uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","description":"Agent description","example":"Answers product questions and escalates billing issues.","uniqueKey":"description","typeLabel":"string"},"isPublic":{"type":"boolean","description":"Whether this agent is public (visible in other projects’ agent select)","default":false,"example":false,"uniqueKey":"isPublic","typeLabel":"boolean"},"agent":{"type":"object","properties":{"prompt":{"type":"string","description":"System prompt / instructions for the agent","example":"You are a helpful support agent. Prefer short answers.","uniqueKey":"agent.prompt","typeLabel":"string"},"modelSettings":{"type":"object","properties":{"model":{"type":"string","description":"Model identifier (e.g. openai/gpt-4o-mini)","example":"openai/gpt-4o-mini","uniqueKey":"agent.modelSettings.model","typeLabel":"string"},"temperature":{"type":"number","minimum":0,"maximum":2,"description":"Temperature 0-2","example":0.7,"uniqueKey":"agent.modelSettings.temperature","typeLabel":"number"},"maxTokens":{"type":"number","description":"Max tokens","example":4096,"uniqueKey":"agent.modelSettings.maxTokens","typeLabel":"number"},"cacheToolsAndPrompt":{"type":"boolean","description":"Cache tools and prompt","example":true,"uniqueKey":"agent.modelSettings.cacheToolsAndPrompt","typeLabel":"boolean"},"topP":{"type":"number","minimum":0,"maximum":1,"description":"Nucleus sampling top_p (0–1)","example":1,"uniqueKey":"agent.modelSettings.topP","typeLabel":"number"},"topK":{"type":"number","minimum":1,"description":"Top-K sampling","example":40,"uniqueKey":"agent.modelSettings.topK","typeLabel":"number"},"frequencyPenalty":{"type":"number","minimum":-2,"maximum":2,"description":"Frequency penalty (−2 to 2)","example":0,"uniqueKey":"agent.modelSettings.frequencyPenalty","typeLabel":"number"},"presencePenalty":{"type":"number","minimum":-2,"maximum":2,"description":"Presence penalty (−2 to 2)","example":0,"uniqueKey":"agent.modelSettings.presencePenalty","typeLabel":"number"},"repetitionPenalty":{"type":"number","minimum":0,"maximum":2,"description":"Repetition penalty (0–2)","example":1,"uniqueKey":"agent.modelSettings.repetitionPenalty","typeLabel":"number"},"minP":{"type":"number","minimum":0,"maximum":1,"description":"min_p sampling (0–1)","example":0,"uniqueKey":"agent.modelSettings.minP","typeLabel":"number"},"topA":{"type":"number","minimum":0,"maximum":1,"description":"Top-A sampling (0–1)","example":0,"uniqueKey":"agent.modelSettings.topA","typeLabel":"number"},"seed":{"type":"number","description":"Random seed for deterministic generation","example":42,"uniqueKey":"agent.modelSettings.seed","typeLabel":"number"},"stop":{"description":"Stop sequences","example":["END"],"type":"array","items":{"type":"string","uniqueKey":"agent.modelSettings.stop.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.modelSettings.stop","typeLabel":"string[]"},"logitBias":{"type":"object","description":"Token id → bias map","additionalProperties":{"type":"number","uniqueKey":"agent.modelSettings.logitBias.additionalProperties","typeLabel":"number"},"example":{"50256":-100},"uniqueKey":"agent.modelSettings.logitBias","typeLabel":"object"},"topLogprobs":{"type":"number","minimum":0,"maximum":20,"description":"Top logprobs to return per token (0–20)","example":0,"uniqueKey":"agent.modelSettings.topLogprobs","typeLabel":"number"},"reasoningEffort":{"type":"string","enum":["none","low","medium","high"],"description":"Reasoning / thinking effort (OpenRouter). none=off; low|medium|high when model supports reasoning_effort.","example":"medium","uniqueKey":"agent.modelSettings.reasoningEffort","typeLabel":"enum\u003cstring>"}},"uniqueKey":"agent.modelSettings","typeLabel":"object"},"capabilities":{"type":"object","properties":{"computer":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable Flowra Computer (E2B sandbox + execute + chat Computer chip) for this agent","example":true,"uniqueKey":"agent.capabilities.computer.enabled","typeLabel":"boolean"},"templateId":{"type":"string","description":"E2B template name or ID (optional; falls back to server default)","example":"code-interpreter-v1","uniqueKey":"agent.capabilities.computer.templateId","typeLabel":"string"},"maxDurationSec":{"type":"number","minimum":1,"description":"Wall-clock cap for billing and session (seconds)","example":3600,"uniqueKey":"agent.capabilities.computer.maxDurationSec","typeLabel":"number"}},"uniqueKey":"agent.capabilities.computer","typeLabel":"object"},"generalPurpose":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable general-purpose deep-agent posture without requiring a real computer","example":false,"uniqueKey":"agent.capabilities.generalPurpose.enabled","typeLabel":"boolean"}},"uniqueKey":"agent.capabilities.generalPurpose","typeLabel":"object"},"summarization":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable summarization middleware","example":true,"uniqueKey":"agent.capabilities.summarization.enabled","typeLabel":"boolean"},"trigger":{"type":"object","description":"Trigger conditions","uniqueKey":"agent.capabilities.summarization.trigger","typeLabel":"object"},"keep":{"type":"object","description":"Keep rule","uniqueKey":"agent.capabilities.summarization.keep","typeLabel":"object"},"model":{"type":"string","description":"Model used for summarization","example":"openai/gpt-4o-mini","uniqueKey":"agent.capabilities.summarization.model","typeLabel":"string"},"maxTokensBeforeSummary":{"type":"number","description":"Max tokens for summary generation","example":1024,"uniqueKey":"agent.capabilities.summarization.maxTokensBeforeSummary","typeLabel":"number"},"prefix":{"type":"string","description":"Prefix to add to summary message","example":"## Conversation so far","uniqueKey":"agent.capabilities.summarization.prefix","typeLabel":"string"}},"uniqueKey":"agent.capabilities.summarization","typeLabel":"object"},"todoList":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable todo/planning tool","example":true,"uniqueKey":"agent.capabilities.todoList.enabled","typeLabel":"boolean"},"strict":{"type":"boolean","description":"Strict planning mode","example":false,"uniqueKey":"agent.capabilities.todoList.strict","typeLabel":"boolean"}},"uniqueKey":"agent.capabilities.todoList","typeLabel":"object"},"toolRetry":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable tool retry","example":true,"uniqueKey":"agent.capabilities.toolRetry.enabled","typeLabel":"boolean"},"maxRetries":{"type":"number","minimum":0,"description":"Max retries","example":2,"uniqueKey":"agent.capabilities.toolRetry.maxRetries","typeLabel":"number"},"backoffFactor":{"type":"number","minimum":0,"description":"Backoff factor","example":2,"uniqueKey":"agent.capabilities.toolRetry.backoffFactor","typeLabel":"number"},"initialDelayMs":{"type":"number","minimum":0,"description":"Initial delay ms","example":500,"uniqueKey":"agent.capabilities.toolRetry.initialDelayMs","typeLabel":"number"},"maxDelayMs":{"type":"number","minimum":0,"description":"Max delay ms","example":8000,"uniqueKey":"agent.capabilities.toolRetry.maxDelayMs","typeLabel":"number"},"jitter":{"type":"boolean","description":"Add jitter to backoff","example":true,"uniqueKey":"agent.capabilities.toolRetry.jitter","typeLabel":"boolean"},"tools":{"description":"Retry only these tool names","type":"array","items":{"type":"string","uniqueKey":"agent.capabilities.toolRetry.tools.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.capabilities.toolRetry.tools","typeLabel":"string[]"},"onFailure":{"type":"string","description":"Behavior when retries exhausted","enum":["continue","error"],"uniqueKey":"agent.capabilities.toolRetry.onFailure","typeLabel":"enum\u003cstring>"}},"uniqueKey":"agent.capabilities.toolRetry","typeLabel":"object"},"modelFallback":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable model fallback (resilience)","uniqueKey":"agent.capabilities.modelFallback.enabled","typeLabel":"boolean"},"fallbackModels":{"description":"Fallback model ids in order","type":"array","items":{"type":"string","uniqueKey":"agent.capabilities.modelFallback.fallbackModels.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.capabilities.modelFallback.fallbackModels","typeLabel":"string[]"}},"uniqueKey":"agent.capabilities.modelFallback","typeLabel":"object"},"toolSelector":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable LLM tool selector","uniqueKey":"agent.capabilities.toolSelector.enabled","typeLabel":"boolean"},"model":{"type":"string","description":"Selector model","uniqueKey":"agent.capabilities.toolSelector.model","typeLabel":"string"},"maxTools":{"type":"number","minimum":1,"description":"Max tools to include","uniqueKey":"agent.capabilities.toolSelector.maxTools","typeLabel":"number"},"alwaysInclude":{"description":"Tool names always kept by the selector (from agent-assigned tools). Does not count against maxTools.","type":"array","items":{"type":"string","uniqueKey":"agent.capabilities.toolSelector.alwaysInclude.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.capabilities.toolSelector.alwaysInclude","typeLabel":"string[]"},"autoEnableIfToolCountGte":{"type":"number","minimum":1,"description":"Auto enable if tool count >= N","uniqueKey":"agent.capabilities.toolSelector.autoEnableIfToolCountGte","typeLabel":"number"}},"uniqueKey":"agent.capabilities.toolSelector","typeLabel":"object"},"humanApproval":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable human approval for sensitive tools","uniqueKey":"agent.capabilities.humanApproval.enabled","typeLabel":"boolean"},"mode":{"type":"string","description":"Approval mode","enum":["sensitiveOnly"],"uniqueKey":"agent.capabilities.humanApproval.mode","typeLabel":"enum\u003cstring>"},"sensitiveToolNames":{"description":"Tool names requiring approval","type":"array","items":{"type":"string","uniqueKey":"agent.capabilities.humanApproval.sensitiveToolNames.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.capabilities.humanApproval.sensitiveToolNames","typeLabel":"string[]"},"alwaysAllowedToolNames":{"description":"Tool names always allowed (no approval)","type":"array","items":{"type":"string","uniqueKey":"agent.capabilities.humanApproval.alwaysAllowedToolNames.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.capabilities.humanApproval.alwaysAllowedToolNames","typeLabel":"string[]"},"allowedDecisions":{"description":"Allowed decisions","type":"array","items":{"type":"string","uniqueKey":"agent.capabilities.humanApproval.allowedDecisions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.capabilities.humanApproval.allowedDecisions","typeLabel":"string[]"},"messageToUser":{"type":"string","description":"Message shown to user on approval request","uniqueKey":"agent.capabilities.humanApproval.messageToUser","typeLabel":"string"}},"uniqueKey":"agent.capabilities.humanApproval","typeLabel":"object"},"modelCallLimit":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable model call limit","uniqueKey":"agent.capabilities.modelCallLimit.enabled","typeLabel":"boolean"},"threadLimit":{"type":"number","minimum":1,"description":"Max model calls per thread","uniqueKey":"agent.capabilities.modelCallLimit.threadLimit","typeLabel":"number"},"runLimit":{"type":"number","minimum":1,"description":"Max model calls per run/invocation","uniqueKey":"agent.capabilities.modelCallLimit.runLimit","typeLabel":"number"},"exitBehavior":{"type":"string","description":"Exit behavior","enum":["end","error"],"uniqueKey":"agent.capabilities.modelCallLimit.exitBehavior","typeLabel":"enum\u003cstring>"}},"uniqueKey":"agent.capabilities.modelCallLimit","typeLabel":"object"},"toolCallLimit":{"type":"object","properties":{"enabled":{"type":"boolean","description":"Enable tool call limit middleware","uniqueKey":"agent.capabilities.toolCallLimit.enabled","typeLabel":"boolean"},"threadLimit":{"type":"number","minimum":1,"description":"Max tool calls per thread","uniqueKey":"agent.capabilities.toolCallLimit.threadLimit","typeLabel":"number"},"runLimit":{"type":"number","minimum":1,"description":"Max tool calls per run/invocation","uniqueKey":"agent.capabilities.toolCallLimit.runLimit","typeLabel":"number"},"exitBehavior":{"type":"string","description":"When limit exceeded: continue (block with errors), end (stop), or error (throw)","enum":["continue","end","error"],"uniqueKey":"agent.capabilities.toolCallLimit.exitBehavior","typeLabel":"enum\u003cstring>"},"toolName":{"type":"string","description":"If set, limits apply only to this tool name (otherwise all tools)","uniqueKey":"agent.capabilities.toolCallLimit.toolName","typeLabel":"string"}},"uniqueKey":"agent.capabilities.toolCallLimit","typeLabel":"object"},"userFriendlyErrors":{"type":"boolean","description":"Enable user-friendly error messages","example":true,"uniqueKey":"agent.capabilities.userFriendlyErrors","typeLabel":"boolean"},"longTermMemory":{"type":"object","properties":{"enabled":{"type":"boolean","description":"When true, the agent can remember important details about each person across chats (only for this agent). Uses deep-agent memory; does not require computer.","uniqueKey":"agent.capabilities.longTermMemory.enabled","typeLabel":"boolean"},"instructions":{"type":"string","maxLength":4000,"description":"Plain-language guidance for what to remember (e.g. reply style, nickname). Skip temporary one-off chatter.","uniqueKey":"agent.capabilities.longTermMemory.instructions","typeLabel":"string"}},"uniqueKey":"agent.capabilities.longTermMemory","typeLabel":"object"}},"uniqueKey":"agent.capabilities","typeLabel":"object"},"skillIds":{"description":"Skill IDs to attach as playbooks.","type":"array","items":{"type":"string","uniqueKey":"agent.skillIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.skillIds","typeLabel":"string[]"},"subAgentIds":{"description":"Child agent workflow IDs (one level).","type":"array","items":{"type":"string","uniqueKey":"agent.subAgentIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.subAgentIds","typeLabel":"string[]"},"knowledgeCollectionIds":{"description":"Knowledge collection IDs this agent can access.","type":"array","items":{"type":"string","uniqueKey":"agent.knowledgeCollectionIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.knowledgeCollectionIds","typeLabel":"string[]"},"databaseCollectionIds":{"description":"Database collection IDs this agent can access.","type":"array","items":{"type":"string","uniqueKey":"agent.databaseCollectionIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.databaseCollectionIds","typeLabel":"string[]"},"databaseAccessPolicies":{"type":"object","description":"Per-collection end-user access policies (keyed by collectionId).","additionalProperties":true,"uniqueKey":"agent.databaseAccessPolicies","typeLabel":"object"},"starterPrompts":{"description":"Suggested starter prompts (max 8, each max 200 chars).","type":"array","items":{"type":"string","maxLength":200,"uniqueKey":"agent.starterPrompts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.starterPrompts","typeLabel":"string[]"},"avatarUrl":{"type":"string","maxLength":500,"description":"Optional agent avatar (`file:\u003cuuid>` or https URL).","uniqueKey":"agent.avatarUrl","typeLabel":"string"},"behavior":{"type":"object","properties":{"persona":{"type":"object","properties":{"displayName":{"type":"string","maxLength":120,"description":"Name the agent introduces itself with.","uniqueKey":"agent.behavior.persona.displayName","typeLabel":"string"},"role":{"type":"string","maxLength":200,"description":"What the agent does, in one short phrase.","uniqueKey":"agent.behavior.persona.role","typeLabel":"string"},"tone":{"type":"string","enum":["professional","friendly","empathetic","concise","technical","playful"],"uniqueKey":"agent.behavior.persona.tone","typeLabel":"enum\u003cstring>"},"verbosity":{"type":"string","enum":["brief","balanced","detailed"],"uniqueKey":"agent.behavior.persona.verbosity","typeLabel":"enum\u003cstring>"},"language":{"type":"string","enum":["match_user","fa","en","ar","tr"],"uniqueKey":"agent.behavior.persona.language","typeLabel":"enum\u003cstring>"},"emoji":{"type":"string","enum":["never","sparing","free"],"uniqueKey":"agent.behavior.persona.emoji","typeLabel":"enum\u003cstring>"},"styleNotes":{"type":"string","maxLength":2000,"description":"Extra style notes, appended verbatim.","uniqueKey":"agent.behavior.persona.styleNotes","typeLabel":"string"}},"uniqueKey":"agent.behavior.persona","typeLabel":"object"},"guardrails":{"type":"object","properties":{"bannedTopics":{"description":"Subjects the agent must decline.","type":"array","items":{"type":"string","maxLength":200,"uniqueKey":"agent.behavior.guardrails.bannedTopics.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.behavior.guardrails.bannedTopics","typeLabel":"string[]"},"neverPromise":{"description":"Things the agent must never commit to.","type":"array","items":{"type":"string","maxLength":200,"uniqueKey":"agent.behavior.guardrails.neverPromise.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.behavior.guardrails.neverPromise","typeLabel":"string[]"},"refusalMessage":{"type":"string","maxLength":1000,"description":"What the agent says when it declines.","uniqueKey":"agent.behavior.guardrails.refusalMessage","typeLabel":"string"},"groundingMode":{"type":"string","enum":["off","prefer_sources","strict"],"uniqueKey":"agent.behavior.guardrails.groundingMode","typeLabel":"enum\u003cstring>"},"pii":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"agent.behavior.guardrails.pii.enabled","typeLabel":"boolean"},"rules":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["email","credit_card","ip","mac_address","url","custom"],"uniqueKey":"agent.behavior.guardrails.pii.rules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"strategy":{"type":"string","enum":["block","redact","mask","hash"],"uniqueKey":"agent.behavior.guardrails.pii.rules.items.[INDEX].strategy","typeLabel":"enum\u003cstring>"},"pattern":{"type":"string","maxLength":500,"description":"Regex source. Required when type is `custom`.","uniqueKey":"agent.behavior.guardrails.pii.rules.items.[INDEX].pattern","typeLabel":"string"},"applyToInput":{"type":"boolean","uniqueKey":"agent.behavior.guardrails.pii.rules.items.[INDEX].applyToInput","typeLabel":"boolean"},"applyToOutput":{"type":"boolean","uniqueKey":"agent.behavior.guardrails.pii.rules.items.[INDEX].applyToOutput","typeLabel":"boolean"}},"uniqueKey":"agent.behavior.guardrails.pii.rules.items.[INDEX]","typeLabel":"object"},"uniqueKey":"agent.behavior.guardrails.pii.rules","typeLabel":"object[]"}},"uniqueKey":"agent.behavior.guardrails.pii","typeLabel":"object"}},"uniqueKey":"agent.behavior.guardrails","typeLabel":"object"},"escalation":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"agent.behavior.escalation.enabled","typeLabel":"boolean"},"triggers":{"description":"Situations that require a human.","type":"array","items":{"type":"string","maxLength":200,"uniqueKey":"agent.behavior.escalation.triggers.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.behavior.escalation.triggers","typeLabel":"string[]"},"afterFailedAttempts":{"type":"number","minimum":1,"maximum":10,"uniqueKey":"agent.behavior.escalation.afterFailedAttempts","typeLabel":"number"},"action":{"type":"string","enum":["reply_only","notify_tool","human_approval"],"description":"reply_only and notify_tool pause messaging-channel auto-reply until an operator hands back. human_approval is tool HITL only.","uniqueKey":"agent.behavior.escalation.action","typeLabel":"enum\u003cstring>"},"notifyToolSlug":{"type":"string","maxLength":200,"description":"Tool used to notify a human; must also be pinned.","uniqueKey":"agent.behavior.escalation.notifyToolSlug","typeLabel":"string"},"summaryTemplate":{"type":"string","maxLength":1000,"description":"Shape of the handoff summary.","uniqueKey":"agent.behavior.escalation.summaryTemplate","typeLabel":"string"},"handoffMessage":{"type":"string","maxLength":1000,"description":"What the agent says while handing off.","uniqueKey":"agent.behavior.escalation.handoffMessage","typeLabel":"string"}},"uniqueKey":"agent.behavior.escalation","typeLabel":"object"},"usageCaps":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"agent.behavior.usageCaps.enabled","typeLabel":"boolean"},"messagesPerUserPerDay":{"type":"number","minimum":1,"description":"Per end user, per rolling day.","uniqueKey":"agent.behavior.usageCaps.messagesPerUserPerDay","typeLabel":"number"},"maxTurnsPerConversation":{"type":"number","minimum":1,"uniqueKey":"agent.behavior.usageCaps.maxTurnsPerConversation","typeLabel":"number"},"maxCreditsPerConversation":{"type":"number","minimum":1,"uniqueKey":"agent.behavior.usageCaps.maxCreditsPerConversation","typeLabel":"number"},"onExceeded":{"type":"string","enum":["stop","escalate"],"uniqueKey":"agent.behavior.usageCaps.onExceeded","typeLabel":"enum\u003cstring>"},"exceededMessage":{"type":"string","maxLength":1000,"description":"Shown to the end user once a cap is hit.","uniqueKey":"agent.behavior.usageCaps.exceededMessage","typeLabel":"string"}},"uniqueKey":"agent.behavior.usageCaps","typeLabel":"object"},"cannedResponses":{"type":"object","properties":{"greeting":{"type":"string","maxLength":1000,"uniqueKey":"agent.behavior.cannedResponses.greeting","typeLabel":"string"},"fallback":{"type":"string","maxLength":1000,"description":"Used when the agent genuinely does not know.","uniqueKey":"agent.behavior.cannedResponses.fallback","typeLabel":"string"},"outOfHours":{"type":"string","maxLength":1000,"uniqueKey":"agent.behavior.cannedResponses.outOfHours","typeLabel":"string"},"businessHours":{"type":"object","properties":{"timezone":{"type":"string","maxLength":64,"description":"IANA timezone, e.g. Asia/Tehran.","uniqueKey":"agent.behavior.cannedResponses.businessHours.timezone","typeLabel":"string"},"days":{"description":"0 = Sunday … 6 = Saturday.","type":"array","items":{"type":"number","maximum":6,"minimum":0,"uniqueKey":"agent.behavior.cannedResponses.businessHours.days.items.[INDEX]","typeLabel":"number"},"uniqueKey":"agent.behavior.cannedResponses.businessHours.days","typeLabel":"number[]"},"start":{"type":"string","maxLength":5,"description":"HH:mm","uniqueKey":"agent.behavior.cannedResponses.businessHours.start","typeLabel":"string"},"end":{"type":"string","maxLength":5,"description":"HH:mm","uniqueKey":"agent.behavior.cannedResponses.businessHours.end","typeLabel":"string"}},"uniqueKey":"agent.behavior.cannedResponses.businessHours","typeLabel":"object"}},"uniqueKey":"agent.behavior.cannedResponses","typeLabel":"object"}},"uniqueKey":"agent.behavior","typeLabel":"object"},"identity":{"type":"object","properties":{"mode":{"type":"string","enum":["anonymous","collect","required"],"description":"anonymous (default) | collect (optional form) | required (gate before chat)","uniqueKey":"agent.identity.mode","typeLabel":"enum\u003cstring>"},"methods":{"description":"How the end user may prove identity: host_hmac, host_jwt, email_otp, channel_native, sdk_username, toolkit_connection","type":"array","items":{"type":"string","uniqueKey":"agent.identity.methods.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.identity.methods","typeLabel":"string[]"},"collect":{"description":"Profile fields to collect: name, email, phone","type":"array","items":{"type":"string","uniqueKey":"agent.identity.collect.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.identity.collect","typeLabel":"string[]"},"linkBy":{"description":"Join the same person across surfaces by verified email and/or phone","type":"array","items":{"type":"string","uniqueKey":"agent.identity.linkBy.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.identity.linkBy","typeLabel":"string[]"},"allowedEmailDomains":{"description":"When set, verified email must match one of these domains (e.g. acme.com)","type":"array","items":{"type":"string","maxLength":255,"uniqueKey":"agent.identity.allowedEmailDomains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.identity.allowedEmailDomains","typeLabel":"string[]"},"toolkitSlug":{"type":"string","maxLength":128,"description":"Toolkit slug whose ACTIVE connected account proves identity when methods includes toolkit_connection","uniqueKey":"agent.identity.toolkitSlug","typeLabel":"string"}},"uniqueKey":"agent.identity","typeLabel":"object"},"tools":{"type":"object","properties":{"mode":{"enum":["NORMAL","META"],"type":"string","description":"NORMAL = explicit list, META = meta + discovery filters.","example":"NORMAL","uniqueKey":"agent.tools.mode","typeLabel":"enum\u003cstring>"},"discoveryWhitelist":{"type":"boolean","description":"When mode is META: true = discovery limited to pinned toolkit slugs; false = exclude those slugs.","uniqueKey":"agent.tools.discoveryWhitelist","typeLabel":"boolean"},"pinnedSlugs":{"description":"Pinned tool slugs (synced to workflow_tools).","example":["gmail_send_email","gmail_fetch_emails"],"type":"array","items":{"type":"string","uniqueKey":"agent.tools.pinnedSlugs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.tools.pinnedSlugs","typeLabel":"string[]"},"externalMcpConfigs":{"description":"External MCP configs: [{ name, url, headers?, tools }]. tools = selected tool slugs from that MCP.","type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"MCP config name","example":"internal-docs","uniqueKey":"agent.tools.externalMcpConfigs.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","description":"MCP server URL","example":"https://mcp.example.com/sse","uniqueKey":"agent.tools.externalMcpConfigs.items.[INDEX].url","typeLabel":"string"},"headers":{"type":"object","description":"Optional headers","additionalProperties":{"type":"string","uniqueKey":"agent.tools.externalMcpConfigs.items.[INDEX].headers.additionalProperties","typeLabel":"string"},"example":{"Authorization":"Bearer sk_live_..."},"uniqueKey":"agent.tools.externalMcpConfigs.items.[INDEX].headers","typeLabel":"object"},"tools":{"description":"Selected tool slugs from this MCP","example":["search_docs"],"type":"array","items":{"type":"string","uniqueKey":"agent.tools.externalMcpConfigs.items.[INDEX].tools.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.tools.externalMcpConfigs.items.[INDEX].tools","typeLabel":"string[]"}},"uniqueKey":"agent.tools.externalMcpConfigs.items.[INDEX]","typeLabel":"object"},"uniqueKey":"agent.tools.externalMcpConfigs","typeLabel":"object[]"},"connectionCallbackUrl":{"oneOf":[{"type":"string","maxLength":2048,"description":"OAuth return URL after linking toolkit accounts. Empty string clears.","example":"https://myapp.com/oauth/callback","uniqueKey":"agent.tools.connectionCallbackUrl.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":2048,"description":"OAuth return URL after linking toolkit accounts. Empty string clears.","example":"https://myapp.com/oauth/callback","uniqueKey":"agent.tools.connectionCallbackUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"agent.tools.connectionCallbackUrl","typeLabel":"string | null"},"visitorOwnerConnections":{"type":"object","properties":{"enabled":{"type":"boolean","description":"When true, granted toolkits run as the workflow owner for channel/embed visitors. Default false.","uniqueKey":"agent.tools.visitorOwnerConnections.enabled","typeLabel":"boolean"},"toolkits":{"description":"Toolkits (optionally limited to specific slugs) that may use the owner account.","type":"array","items":{"type":"object","properties":{"toolkitSlug":{"type":"string","maxLength":128,"description":"Toolkit slug whose owner account visitors may use.","uniqueKey":"agent.tools.visitorOwnerConnections.toolkits.items.[INDEX].toolkitSlug","typeLabel":"string"},"toolSlugs":{"description":"If set and non-empty, only these tool slugs may use the owner account.","type":"array","items":{"type":"string","uniqueKey":"agent.tools.visitorOwnerConnections.toolkits.items.[INDEX].toolSlugs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"agent.tools.visitorOwnerConnections.toolkits.items.[INDEX].toolSlugs","typeLabel":"string[]"}},"uniqueKey":"agent.tools.visitorOwnerConnections.toolkits.items.[INDEX]","typeLabel":"object"},"uniqueKey":"agent.tools.visitorOwnerConnections.toolkits","typeLabel":"object[]"}},"uniqueKey":"agent.tools.visitorOwnerConnections","typeLabel":"object"}},"uniqueKey":"agent.tools","typeLabel":"object"},"inputSchema":{"type":"object","description":"Extra chat inputs for this agent (JSON Schema).","uniqueKey":"agent.inputSchema","typeLabel":"object"},"outputSchema":{"type":"object","description":"Structured shape for the agent final answer, keyed by field name. Each value is { type, required?, description? }. Omit for free-form text replies.","additionalProperties":true,"uniqueKey":"agent.outputSchema","typeLabel":"object"}},"uniqueKey":"agent","typeLabel":"object"},"triggers":{"description":"Optional cron / channel event triggers (0..N). Dashboard chat is always available.","type":"array","items":{"type":"object","properties":{"kind":{"type":"string","description":"Trigger kind: cron or trigger_tool (dashboard chat is always available)","enum":["cron","trigger_tool"],"example":"cron","uniqueKey":"triggers.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"expression":{"type":"string","description":"Cron expression (required when kind is cron)","example":"0 9 * * 1-5","uniqueKey":"triggers.items.[INDEX].expression","typeLabel":"string"},"timezone":{"type":"string","description":"IANA timezone for cron","example":"Asia/Tehran","uniqueKey":"triggers.items.[INDEX].timezone","typeLabel":"string"},"toolSlug":{"type":"string","description":"Trigger tool slug (required when kind is trigger_tool)","example":"telegram_bot_new_message","uniqueKey":"triggers.items.[INDEX].toolSlug","typeLabel":"string"},"triggerToolInput":{"type":"object","description":"Trigger tool configuration","example":{"allowed_updates":["message"]},"uniqueKey":"triggers.items.[INDEX].triggerToolInput","typeLabel":"object"},"triggerId":{"type":"string","description":"Registered trigger instance id","example":"3fa85f64-5717-4562-b3fc-2c963f66afa6","uniqueKey":"triggers.items.[INDEX].triggerId","typeLabel":"string"}},"uniqueKey":"triggers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"triggers","typeLabel":"object[]"},"provenance":{"type":"object","properties":{"createdByAgent":{"type":"boolean","description":"True when another agent created this workflow","example":false,"uniqueKey":"provenance.createdByAgent","typeLabel":"boolean"},"productCreationDepth":{"type":"number","description":"Nesting depth when created from another agent (0 = user-created)","example":0,"uniqueKey":"provenance.productCreationDepth","typeLabel":"number"},"createdFromWorkflowId":{"type":"string","description":"Parent workflow ID if this agent was spawned from another","example":"3fa85f64-5717-4562-b3fc-2c963f66afa6","uniqueKey":"provenance.createdFromWorkflowId","typeLabel":"string"},"hideFromAgentPicker":{"type":"boolean","description":"Hide from the agent picker in the dashboard","example":false,"uniqueKey":"provenance.hideFromAgentPicker","typeLabel":"boolean"}},"uniqueKey":"provenance","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Support bot","description":"Answers product questions and escalates billing issues.","isPublic":false,"agent":{"prompt":"You are a helpful support agent. Prefer short answers.","modelSettings":{"model":"openai/gpt-4o-mini","temperature":0.7,"maxTokens":4096,"cacheToolsAndPrompt":true,"topP":1,"topK":40,"frequencyPenalty":0,"presencePenalty":0,"repetitionPenalty":1,"minP":0,"topA":0,"seed":42,"stop":["END"],"logitBias":{"50256":-100},"topLogprobs":0,"reasoningEffort":"medium"},"capabilities":{"computer":{"enabled":true,"templateId":"code-interpreter-v1","maxDurationSec":3600},"generalPurpose":{"enabled":false},"summarization":{"enabled":true,"trigger":{},"keep":{},"model":"openai/gpt-4o-mini","maxTokensBeforeSummary":1024,"prefix":"## Conversation so far"},"todoList":{"enabled":true,"strict":false},"toolRetry":{"enabled":true,"maxRetries":2,"backoffFactor":2,"initialDelayMs":500,"maxDelayMs":8000,"jitter":true,"tools":["\u003cstring>"]},"modelFallback":{"enabled":true,"fallbackModels":["\u003cstring>"]},"toolSelector":{"enabled":true,"model":"\u003cstring>","maxTools":2,"alwaysInclude":["\u003cstring>"],"autoEnableIfToolCountGte":2},"humanApproval":{"enabled":true,"mode":"sensitiveOnly","sensitiveToolNames":["\u003cstring>"],"alwaysAllowedToolNames":["\u003cstring>"],"allowedDecisions":["\u003cstring>"],"messageToUser":"\u003cstring>"},"modelCallLimit":{"enabled":true,"threadLimit":2,"runLimit":2},"toolCallLimit":{"enabled":true,"threadLimit":2,"runLimit":2,"toolName":"\u003cstring>"},"userFriendlyErrors":true,"longTermMemory":{"enabled":true,"instructions":"\u003cstring>"}},"skillIds":["\u003cstring>"],"subAgentIds":["\u003cstring>"],"knowledgeCollectionIds":["\u003cstring>"],"databaseCollectionIds":["\u003cstring>"],"databaseAccessPolicies":{},"starterPrompts":["\u003cstring>"],"avatarUrl":"\u003cstring>","behavior":{"persona":{"displayName":"\u003cstring>","role":"\u003cstring>","styleNotes":"\u003cstring>"},"guardrails":{"bannedTopics":["\u003cstring>"],"neverPromise":["\u003cstring>"],"refusalMessage":"\u003cstring>","pii":{"enabled":true,"rules":[{"pattern":"\u003cstring>","applyToInput":true,"applyToOutput":true}]}},"escalation":{"enabled":true,"triggers":["\u003cstring>"],"afterFailedAttempts":5.5,"notifyToolSlug":"\u003cstring>","summaryTemplate":"\u003cstring>","handoffMessage":"\u003cstring>"},"usageCaps":{"enabled":true,"messagesPerUserPerDay":2,"maxTurnsPerConversation":2,"maxCreditsPerConversation":2,"exceededMessage":"\u003cstring>"},"cannedResponses":{"greeting":"\u003cstring>","fallback":"\u003cstring>","outOfHours":"\u003cstring>","businessHours":{"timezone":"\u003cstring>","days":[3],"start":"\u003cstring>","end":"\u003cstring>"}}},"identity":{"methods":["\u003cstring>"],"collect":["\u003cstring>"],"linkBy":["\u003cstring>"],"allowedEmailDomains":["\u003cstring>"],"toolkitSlug":"\u003cstring>"},"tools":{"mode":"NORMAL","discoveryWhitelist":true,"pinnedSlugs":["gmail_send_email","gmail_fetch_emails"],"externalMcpConfigs":[{"name":"internal-docs","url":"https://mcp.example.com/sse","headers":{"Authorization":"Bearer sk_live_..."},"tools":["search_docs"]}],"connectionCallbackUrl":"https://myapp.com/oauth/callback","visitorOwnerConnections":{"enabled":true,"toolkits":[{"toolkitSlug":"\u003cstring>","toolSlugs":["\u003cstring>"]}]}},"inputSchema":{},"outputSchema":{}},"triggers":[{"kind":"cron","expression":"0 9 * * 1-5","timezone":"Asia/Tehran","toolSlug":"telegram_bot_new_message","triggerToolInput":{"allowed_updates":["message"]},"triggerId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"}],"provenance":{"createdByAgent":false,"productCreationDepth":0,"createdFromWorkflowId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","hideFromAgentPicker":false}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"fc6065d9-1001-4a5f-a852-55c48d6ced8e":{"description":"Agent created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Success status","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Success message","example":"Operation completed successfully","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"data.name","typeLabel":"string"},"projectId":{"type":"string","isRequired":true,"uniqueKey":"data.projectId","typeLabel":"string"},"triggers":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["manual","cron","trigger_tool"],"isRequired":true,"uniqueKey":"data.triggers.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"expression":{"type":"string","uniqueKey":"data.triggers.items.[INDEX].expression","typeLabel":"string"},"timezone":{"type":"string","uniqueKey":"data.triggers.items.[INDEX].timezone","typeLabel":"string"},"toolSlug":{"type":"string","uniqueKey":"data.triggers.items.[INDEX].toolSlug","typeLabel":"string"},"triggerToolInput":{"type":"object","uniqueKey":"data.triggers.items.[INDEX].triggerToolInput","typeLabel":"object"},"triggerId":{"type":"string","uniqueKey":"data.triggers.items.[INDEX].triggerId","typeLabel":"string"},"toolkitName":{"type":"string","uniqueKey":"data.triggers.items.[INDEX].toolkitName","typeLabel":"string"},"toolkitLogo":{"type":"string","uniqueKey":"data.triggers.items.[INDEX].toolkitLogo","typeLabel":"string"}},"required":["kind"],"uniqueKey":"data.triggers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.triggers","typeLabel":"object[]"},"workflowType":{"type":"string","enum":["static","agent"],"isRequired":true,"uniqueKey":"data.workflowType","typeLabel":"enum\u003cstring>"},"isActive":{"type":"boolean","isRequired":true,"uniqueKey":"data.isActive","typeLabel":"boolean"},"lifecycle":{"type":"string","enum":["draft","ready"],"description":"Completeness lifecycle. draft = incomplete build (cannot activate); ready = may set isActive true.","isRequired":true,"uniqueKey":"data.lifecycle","typeLabel":"enum\u003cstring>"},"isPublic":{"type":"boolean","description":"Whether this workflow (agent) is public for select in other projects","isRequired":true,"uniqueKey":"data.isPublic","typeLabel":"boolean"},"version":{"type":"string","description":"Version in form 1.0.x; incremented on each update (for marketplace update check)","isRequired":true,"uniqueKey":"data.version","typeLabel":"string"},"executionCount":{"type":"number","isRequired":true,"uniqueKey":"data.executionCount","typeLabel":"number"},"successfulExecutionCount":{"type":"number","description":"Number of executions that finished with status completed","isRequired":true,"uniqueKey":"data.successfulExecutionCount","typeLabel":"number"},"failedExecutionCount":{"type":"number","description":"Number of executions that finished with status failed or timeout","isRequired":true,"uniqueKey":"data.failedExecutionCount","typeLabel":"number"},"connections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.connections.items.[INDEX].id","typeLabel":"string"},"connectionId":{"type":"string","isRequired":true,"uniqueKey":"data.connections.items.[INDEX].connectionId","typeLabel":"string"},"toolkitSlug":{"type":"string","isRequired":true,"uniqueKey":"data.connections.items.[INDEX].toolkitSlug","typeLabel":"string"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"data.connections.items.[INDEX].createdAt","typeLabel":"string"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"data.connections.items.[INDEX].updatedAt","typeLabel":"string"},"displayName":{"oneOf":[{"type":"string","description":"User-defined label from connected_accounts.displayName","uniqueKey":"data.connections.items.[INDEX].displayName.oneOf.0","typeLabel":"string"},{"type":"null","description":"User-defined label from connected_accounts.displayName","uniqueKey":"data.connections.items.[INDEX].displayName.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.connections.items.[INDEX].displayName","typeLabel":"string | null"},"label":{"oneOf":[{"type":"string","description":"Human label (displayName, else toolkit name). Never a UUID.","uniqueKey":"data.connections.items.[INDEX].label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human label (displayName, else toolkit name). Never a UUID.","uniqueKey":"data.connections.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.connections.items.[INDEX].label","typeLabel":"string | null"}},"required":["id","connectionId","toolkitSlug","createdAt","updatedAt"],"uniqueKey":"data.connections.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.connections","typeLabel":"object[]"},"tools":{"description":"Pinned tools from workflow_tools join (enriched).","type":"array","items":{"type":"object","properties":{"toolSlug":{"type":"string","isRequired":true,"uniqueKey":"data.tools.items.[INDEX].toolSlug","typeLabel":"string"},"toolName":{"type":"string","isRequired":true,"uniqueKey":"data.tools.items.[INDEX].toolName","typeLabel":"string"},"toolkitName":{"type":"string","isRequired":true,"uniqueKey":"data.tools.items.[INDEX].toolkitName","typeLabel":"string"},"toolkitLogo":{"type":"string","uniqueKey":"data.tools.items.[INDEX].toolkitLogo","typeLabel":"string"}},"required":["toolSlug","toolName","toolkitName"],"uniqueKey":"data.tools.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.tools","typeLabel":"object[]"},"createdAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"marketplaceCapabilities":{"type":"object","properties":{"hasSkills":{"type":"boolean","uniqueKey":"data.marketplaceCapabilities.hasSkills","typeLabel":"boolean"},"skillCount":{"type":"number","uniqueKey":"data.marketplaceCapabilities.skillCount","typeLabel":"number"},"hasKnowledge":{"type":"boolean","uniqueKey":"data.marketplaceCapabilities.hasKnowledge","typeLabel":"boolean"},"hasDatabase":{"type":"boolean","uniqueKey":"data.marketplaceCapabilities.hasDatabase","typeLabel":"boolean"},"hasCron":{"type":"boolean","uniqueKey":"data.marketplaceCapabilities.hasCron","typeLabel":"boolean"},"requiresAuth":{"type":"boolean","uniqueKey":"data.marketplaceCapabilities.requiresAuth","typeLabel":"boolean"},"toolkitCount":{"type":"number","uniqueKey":"data.marketplaceCapabilities.toolkitCount","typeLabel":"number"},"subAgentCount":{"type":"number","uniqueKey":"data.marketplaceCapabilities.subAgentCount","typeLabel":"number"},"toolCount":{"type":"number","uniqueKey":"data.marketplaceCapabilities.toolCount","typeLabel":"number"}},"isRequired":true,"uniqueKey":"data.marketplaceCapabilities","typeLabel":"object"},"description":{"type":"string","uniqueKey":"data.description","typeLabel":"string"},"agent":{"type":"object","properties":{"prompt":{"type":"string","isRequired":true,"uniqueKey":"data.agent.prompt","typeLabel":"string"},"tools":{"type":"object","properties":{"mode":{"enum":["NORMAL","META"],"type":"string","isRequired":true,"uniqueKey":"data.agent.tools.mode","typeLabel":"enum\u003cstring>"},"discoveryWhitelist":{"type":"boolean","uniqueKey":"data.agent.tools.discoveryWhitelist","typeLabel":"boolean"},"pinnedSlugs":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.tools.pinnedSlugs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.tools.pinnedSlugs","typeLabel":"string[]"},"externalMcpConfigs":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.tools.externalMcpConfigs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.tools.externalMcpConfigs","typeLabel":"string[]"},"connectionCallbackUrl":{"oneOf":[{"type":"string","uniqueKey":"data.agent.tools.connectionCallbackUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.agent.tools.connectionCallbackUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.agent.tools.connectionCallbackUrl","typeLabel":"string | null"},"visitorOwnerConnections":{"type":"object","properties":{"enabled":{"type":"boolean","isRequired":true,"uniqueKey":"data.agent.tools.visitorOwnerConnections.enabled","typeLabel":"boolean"},"toolkits":{"type":"array","items":{"type":"object","properties":{"toolkitSlug":{"type":"string","isRequired":true,"uniqueKey":"data.agent.tools.visitorOwnerConnections.toolkits.items.[INDEX].toolkitSlug","typeLabel":"string"},"toolSlugs":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.tools.visitorOwnerConnections.toolkits.items.[INDEX].toolSlugs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.tools.visitorOwnerConnections.toolkits.items.[INDEX].toolSlugs","typeLabel":"string[]"}},"required":["toolkitSlug"],"uniqueKey":"data.agent.tools.visitorOwnerConnections.toolkits.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.agent.tools.visitorOwnerConnections.toolkits","typeLabel":"object[]"}},"required":["enabled","toolkits"],"uniqueKey":"data.agent.tools.visitorOwnerConnections","typeLabel":"object"}},"required":["mode"],"isRequired":true,"uniqueKey":"data.agent.tools","typeLabel":"object"},"modelSettings":{"type":"object","uniqueKey":"data.agent.modelSettings","typeLabel":"object"},"capabilities":{"type":"object","uniqueKey":"data.agent.capabilities","typeLabel":"object"},"behavior":{"type":"object","uniqueKey":"data.agent.behavior","typeLabel":"object"},"identity":{"type":"object","uniqueKey":"data.agent.identity","typeLabel":"object"},"skillIds":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.skillIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.skillIds","typeLabel":"string[]"},"subAgentIds":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.subAgentIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.subAgentIds","typeLabel":"string[]"},"knowledgeCollectionIds":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.knowledgeCollectionIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.knowledgeCollectionIds","typeLabel":"string[]"},"databaseCollectionIds":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.databaseCollectionIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.databaseCollectionIds","typeLabel":"string[]"},"databaseAccessPolicies":{"type":"object","uniqueKey":"data.agent.databaseAccessPolicies","typeLabel":"object"},"starterPrompts":{"type":"array","items":{"type":"string","uniqueKey":"data.agent.starterPrompts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.agent.starterPrompts","typeLabel":"string[]"},"avatarUrl":{"type":"string","uniqueKey":"data.agent.avatarUrl","typeLabel":"string"},"inputSchema":{"type":"object","uniqueKey":"data.agent.inputSchema","typeLabel":"object"},"outputSchema":{"type":"object","uniqueKey":"data.agent.outputSchema","typeLabel":"object"}},"required":["prompt","tools"],"uniqueKey":"data.agent","typeLabel":"object"},"graph":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"data.graph.nodes.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["action","code","llm_agent","start","end","human_wait"],"isRequired":true,"uniqueKey":"data.graph.nodes.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"toolSlug":{"type":"string","uniqueKey":"data.graph.nodes.items.[INDEX].toolSlug","typeLabel":"string"},"inputMapping":{"type":"object","uniqueKey":"data.graph.nodes.items.[INDEX].inputMapping","typeLabel":"object"},"code":{"type":"string","uniqueKey":"data.graph.nodes.items.[INDEX].code","typeLabel":"string"},"agent":{"type":"object","properties":{"prompt":{"type":"string","isRequired":true,"uniqueKey":"data.graph.nodes.items.[INDEX].agent.prompt","typeLabel":"string"},"modelSettings":{"type":"object","uniqueKey":"data.graph.nodes.items.[INDEX].agent.modelSettings","typeLabel":"object"},"toolSlugs":{"type":"array","items":{"type":"string","uniqueKey":"data.graph.nodes.items.[INDEX].agent.toolSlugs.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.graph.nodes.items.[INDEX].agent.toolSlugs","typeLabel":"string[]"},"knowledgeCollectionIds":{"type":"array","items":{"type":"string","uniqueKey":"data.graph.nodes.items.[INDEX].agent.knowledgeCollectionIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.graph.nodes.items.[INDEX].agent.knowledgeCollectionIds","typeLabel":"string[]"},"databaseCollectionIds":{"type":"array","items":{"type":"string","uniqueKey":"data.graph.nodes.items.[INDEX].agent.databaseCollectionIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.graph.nodes.items.[INDEX].agent.databaseCollectionIds","typeLabel":"string[]"},"databaseAccessPolicies":{"type":"object","uniqueKey":"data.graph.nodes.items.[INDEX].agent.databaseAccessPolicies","typeLabel":"object"}},"required":["prompt"],"uniqueKey":"data.graph.nodes.items.[INDEX].agent","typeLabel":"object"},"outputSchema":{"type":"object","uniqueKey":"data.graph.nodes.items.[INDEX].outputSchema","typeLabel":"object"}},"required":["id","type"],"uniqueKey":"data.graph.nodes.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.graph.nodes","typeLabel":"object[]"},"edges":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string","isRequired":true,"uniqueKey":"data.graph.edges.items.[INDEX].from","typeLabel":"string"},"to":{"type":"string","isRequired":true,"uniqueKey":"data.graph.edges.items.[INDEX].to","typeLabel":"string"},"condition":{"type":"string","uniqueKey":"data.graph.edges.items.[INDEX].condition","typeLabel":"string"}},"required":["from","to"],"uniqueKey":"data.graph.edges.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.graph.edges","typeLabel":"object[]"},"inputSchema":{"type":"object","uniqueKey":"data.graph.inputSchema","typeLabel":"object"},"outputSchema":{"type":"object","uniqueKey":"data.graph.outputSchema","typeLabel":"object"}},"required":["nodes","edges"],"uniqueKey":"data.graph","typeLabel":"object"},"provenance":{"type":"object","properties":{"marketplaceClone":{"type":"object","properties":{"sourceWorkflowId":{"type":"string","uniqueKey":"data.provenance.marketplaceClone.sourceWorkflowId","typeLabel":"string"},"clonedAt":{"type":"string","uniqueKey":"data.provenance.marketplaceClone.clonedAt","typeLabel":"string"},"skillIdMap":{"type":"object","uniqueKey":"data.provenance.marketplaceClone.skillIdMap","typeLabel":"object"},"knowledgeIdMap":{"type":"object","uniqueKey":"data.provenance.marketplaceClone.knowledgeIdMap","typeLabel":"object"},"databaseIdMap":{"type":"object","uniqueKey":"data.provenance.marketplaceClone.databaseIdMap","typeLabel":"object"},"subAgentIdMap":{"type":"object","uniqueKey":"data.provenance.marketplaceClone.subAgentIdMap","typeLabel":"object"},"avatarFileIdMap":{"type":"object","uniqueKey":"data.provenance.marketplaceClone.avatarFileIdMap","typeLabel":"object"},"setupState":{"type":"object","properties":{"answers":{"type":"object","uniqueKey":"data.provenance.marketplaceClone.setupState.answers","typeLabel":"object"},"completedStepIds":{"type":"array","items":{"type":"string","uniqueKey":"data.provenance.marketplaceClone.setupState.completedStepIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.provenance.marketplaceClone.setupState.completedStepIds","typeLabel":"string[]"}},"uniqueKey":"data.provenance.marketplaceClone.setupState","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.provenance.marketplaceClone","typeLabel":"object"},"createdByAgent":{"type":"boolean","uniqueKey":"data.provenance.createdByAgent","typeLabel":"boolean"},"productCreationDepth":{"type":"number","uniqueKey":"data.provenance.productCreationDepth","typeLabel":"number"},"createdFromWorkflowId":{"type":"string","uniqueKey":"data.provenance.createdFromWorkflowId","typeLabel":"string"},"hideFromAgentPicker":{"type":"boolean","uniqueKey":"data.provenance.hideFromAgentPicker","typeLabel":"boolean"}},"required":["marketplaceClone"],"uniqueKey":"data.provenance","typeLabel":"object"},"clonedFromWorkflowId":{"oneOf":[{"type":"string","description":"If cloned from marketplace: source workflow id","uniqueKey":"data.clonedFromWorkflowId.oneOf.0","typeLabel":"string"},{"type":"null","description":"If cloned from marketplace: source workflow id","uniqueKey":"data.clonedFromWorkflowId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.clonedFromWorkflowId","typeLabel":"string | null"},"clonedFromVersion":{"oneOf":[{"type":"string","description":"Source workflow version at clone time (e.g. 1.0.1)","uniqueKey":"data.clonedFromVersion.oneOf.0","typeLabel":"string"},{"type":"null","description":"Source workflow version at clone time (e.g. 1.0.1)","uniqueKey":"data.clonedFromVersion.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.clonedFromVersion","typeLabel":"string | null"},"lastExecutedAt":{"type":"string","uniqueKey":"data.lastExecutedAt","typeLabel":"string"},"subAgents":{"description":"Resolved child specialists (hidden from the agent list).","type":"array","items":{"type":"string","uniqueKey":"data.subAgents.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.subAgents","typeLabel":"string[]"},"sourceVersionLatest":{"type":"string","description":"When workflow is cloned from marketplace: latest version of source (for \"update available\" UI).","example":"1.0.2","uniqueKey":"data.sourceVersionLatest","typeLabel":"string"},"toolkitAuthConfigs":{"description":"Agent-only: toolkitSlug → AuthConfig bindings.","type":"array","items":{"type":"object","properties":{"toolkitSlug":{"type":"string","isRequired":true,"uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].toolkitSlug","typeLabel":"string"},"authConfigId":{"type":"string","isRequired":true,"uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].authConfigId","typeLabel":"string"},"name":{"oneOf":[{"type":"string","uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].name","typeLabel":"string | null"},"authScheme":{"oneOf":[{"type":"string","uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].authScheme.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].authScheme.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].authScheme","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.toolkitAuthConfigs.items.[INDEX].status","typeLabel":"string | null"}},"required":["toolkitSlug","authConfigId"],"uniqueKey":"data.toolkitAuthConfigs.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.toolkitAuthConfigs","typeLabel":"object[]"},"toolkitConnections":{"description":"Static + cron agents: preferred ConnectedAccount binds (chat/trigger do not use these).","type":"array","items":{"type":"object","properties":{"toolkitSlug":{"type":"string","isRequired":true,"uniqueKey":"data.toolkitConnections.items.[INDEX].toolkitSlug","typeLabel":"string"},"connectedAccountId":{"type":"string","isRequired":true,"uniqueKey":"data.toolkitConnections.items.[INDEX].connectedAccountId","typeLabel":"string"},"displayName":{"oneOf":[{"type":"string","uniqueKey":"data.toolkitConnections.items.[INDEX].displayName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.toolkitConnections.items.[INDEX].displayName.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.toolkitConnections.items.[INDEX].displayName","typeLabel":"string | null"},"label":{"oneOf":[{"type":"string","description":"Human label (displayName or provider identity). Never a UUID.","uniqueKey":"data.toolkitConnections.items.[INDEX].label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human label (displayName or provider identity). Never a UUID.","uniqueKey":"data.toolkitConnections.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.toolkitConnections.items.[INDEX].label","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","uniqueKey":"data.toolkitConnections.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.toolkitConnections.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.toolkitConnections.items.[INDEX].status","typeLabel":"string | null"},"authConfigId":{"oneOf":[{"type":"string","uniqueKey":"data.toolkitConnections.items.[INDEX].authConfigId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.toolkitConnections.items.[INDEX].authConfigId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.toolkitConnections.items.[INDEX].authConfigId","typeLabel":"string | null"}},"required":["toolkitSlug","connectedAccountId"],"uniqueKey":"data.toolkitConnections.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.toolkitConnections","typeLabel":"object[]"},"marketplaceCategory":{"oneOf":[{"type":"string","description":"Marketplace listing category","uniqueKey":"data.marketplaceCategory.oneOf.0","typeLabel":"string"},{"type":"null","description":"Marketplace listing category","uniqueKey":"data.marketplaceCategory.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceCategory","typeLabel":"string | null"},"marketplaceAudience":{"oneOf":[{"type":"string","description":"Marketplace audience: for_you | for_your_users | both","uniqueKey":"data.marketplaceAudience.oneOf.0","typeLabel":"string"},{"type":"null","description":"Marketplace audience: for_you | for_your_users | both","uniqueKey":"data.marketplaceAudience.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceAudience","typeLabel":"string | null"},"marketplaceTagline":{"oneOf":[{"type":"string","uniqueKey":"data.marketplaceTagline.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.marketplaceTagline.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceTagline","typeLabel":"string | null"},"marketplaceSetupGuide":{"oneOf":[{"type":"string","uniqueKey":"data.marketplaceSetupGuide.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.marketplaceSetupGuide.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceSetupGuide","typeLabel":"string | null"},"marketplaceSetupSpec":{"oneOf":[{"type":"object","uniqueKey":"data.marketplaceSetupSpec.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.marketplaceSetupSpec.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceSetupSpec","typeLabel":"object | null"},"marketplaceSetupSkillId":{"oneOf":[{"type":"string","uniqueKey":"data.marketplaceSetupSkillId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.marketplaceSetupSkillId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceSetupSkillId","typeLabel":"string | null"},"marketplaceSetupSkillSlug":{"oneOf":[{"type":"string","uniqueKey":"data.marketplaceSetupSkillSlug.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.marketplaceSetupSkillSlug.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceSetupSkillSlug","typeLabel":"string | null"},"marketplaceHighlights":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.marketplaceHighlights.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.marketplaceHighlights.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"data.marketplaceHighlights.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.marketplaceHighlights","typeLabel":"string[] | null"},"marketplaceIsListed":{"type":"boolean","description":"When false, listing is hidden from the public catalog","uniqueKey":"data.marketplaceIsListed","typeLabel":"boolean"}},"required":["id","name","projectId","triggers","workflowType","isActive","lifecycle","isPublic","version","executionCount","successfulExecutionCount","failedExecutionCount","connections","tools","createdAt","updatedAt","marketplaceCapabilities"],"example":{"id":"","name":"","description":"","projectId":"","agent":{"prompt":"","modelSettings":{},"capabilities":{},"behavior":{},"identity":{},"skillIds":[""],"subAgentIds":[""],"knowledgeCollectionIds":[""],"databaseCollectionIds":[""],"databaseAccessPolicies":{},"starterPrompts":[""],"avatarUrl":"","tools":{"mode":"NORMAL","discoveryWhitelist":true,"pinnedSlugs":[""],"externalMcpConfigs":[""],"connectionCallbackUrl":"","visitorOwnerConnections":{"enabled":true,"toolkits":[]}},"inputSchema":{},"outputSchema":{}},"graph":{"nodes":[{"id":"","type":"action","toolSlug":"","inputMapping":{},"code":"","agent":{},"outputSchema":{}}],"edges":[{"from":"","to":"","condition":""}],"inputSchema":{},"outputSchema":{}},"provenance":{"createdByAgent":true,"productCreationDepth":0,"createdFromWorkflowId":"","hideFromAgentPicker":true,"marketplaceClone":{"sourceWorkflowId":"","clonedAt":"","skillIdMap":{},"knowledgeIdMap":{},"databaseIdMap":{},"subAgentIdMap":{},"avatarFileIdMap":{},"setupState":{"answers":{},"completedStepIds":[""]}}},"triggers":[{"kind":"manual","expression":"","timezone":"","toolSlug":"","triggerToolInput":{},"triggerId":"","toolkitName":"","toolkitLogo":""}],"workflowType":"static","isActive":true,"lifecycle":"draft","isPublic":true,"version":"","clonedFromWorkflowId":"","clonedFromVersion":"","executionCount":0,"successfulExecutionCount":0,"failedExecutionCount":0,"lastExecutedAt":"","connections":[{"id":"","connectionId":"","toolkitSlug":"","displayName":"","label":"","createdAt":"","updatedAt":""}],"tools":[{"toolSlug":"","toolName":"","toolkitName":"","toolkitLogo":""}],"subAgents":[""],"createdAt":"2024-01-01T00:00:00.000Z","updatedAt":"2024-01-01T00:00:00.000Z","sourceVersionLatest":"1.0.2","toolkitAuthConfigs":[{"toolkitSlug":"","authConfigId":"","name":"","authScheme":"","status":""}],"toolkitConnections":[{"toolkitSlug":"","connectedAccountId":"","displayName":"","label":"","status":"","authConfigId":""}],"marketplaceCategory":"","marketplaceAudience":"","marketplaceTagline":"","marketplaceSetupGuide":"","marketplaceSetupSpec":{},"marketplaceSetupSkillId":"","marketplaceSetupSkillSlug":"","marketplaceHighlights":[""],"marketplaceIsListed":true,"marketplaceCapabilities":{"hasSkills":true,"skillCount":0,"hasKnowledge":true,"hasDatabase":true,"hasCron":true,"requiresAuth":true,"toolkitCount":0,"subAgentCount":0,"toolCount":0}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["success","message","data"],"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"message":"Operation completed successfully","data":{"id":"","name":"","description":"","projectId":"","agent":{"prompt":"","modelSettings":{},"capabilities":{},"behavior":{},"identity":{},"skillIds":[""],"subAgentIds":[""],"knowledgeCollectionIds":[""],"databaseCollectionIds":[""],"databaseAccessPolicies":{},"starterPrompts":[""],"avatarUrl":"","tools":{"mode":"NORMAL","discoveryWhitelist":true,"pinnedSlugs":[""],"externalMcpConfigs":[""],"connectionCallbackUrl":"","visitorOwnerConnections":{"enabled":true,"toolkits":[]}},"inputSchema":{},"outputSchema":{}},"graph":{"nodes":[{"id":"","type":"action","toolSlug":"","inputMapping":{},"code":"","agent":{},"outputSchema":{}}],"edges":[{"from":"","to":"","condition":""}],"inputSchema":{},"outputSchema":{}},"provenance":{"createdByAgent":true,"productCreationDepth":0,"createdFromWorkflowId":"","hideFromAgentPicker":true,"marketplaceClone":{"sourceWorkflowId":"","clonedAt":"","skillIdMap":{},"knowledgeIdMap":{},"databaseIdMap":{},"subAgentIdMap":{},"avatarFileIdMap":{},"setupState":{"answers":{},"completedStepIds":[""]}}},"triggers":[{"kind":"manual","expression":"","timezone":"","toolSlug":"","triggerToolInput":{},"triggerId":"","toolkitName":"","toolkitLogo":""}],"workflowType":"static","isActive":true,"lifecycle":"draft","isPublic":true,"version":"","clonedFromWorkflowId":"","clonedFromVersion":"","executionCount":0,"successfulExecutionCount":0,"failedExecutionCount":0,"lastExecutedAt":"","connections":[{"id":"","connectionId":"","toolkitSlug":"","displayName":"","label":"","createdAt":"","updatedAt":""}],"tools":[{"toolSlug":"","toolName":"","toolkitName":"","toolkitLogo":""}],"subAgents":[""],"createdAt":"2024-01-01T00:00:00.000Z","updatedAt":"2024-01-01T00:00:00.000Z","sourceVersionLatest":"1.0.2","toolkitAuthConfigs":[{"toolkitSlug":"","authConfigId":"","name":"","authScheme":"","status":""}],"toolkitConnections":[{"toolkitSlug":"","connectedAccountId":"","displayName":"","label":"","status":"","authConfigId":""}],"marketplaceCategory":"","marketplaceAudience":"","marketplaceTagline":"","marketplaceSetupGuide":"","marketplaceSetupSpec":{},"marketplaceSetupSkillId":"","marketplaceSetupSkillSlug":"","marketplaceHighlights":[""],"marketplaceIsListed":true,"marketplaceCapabilities":{"hasSkills":true,"skillCount":0,"hasKnowledge":true,"hasDatabase":true,"hasCron":true,"requiresAuth":true,"toolkitCount":0,"subAgentCount":0,"toolCount":0}}},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Operation completed successfully","data":{"id":"","name":"","description":"","projectId":"","agent":{"prompt":"","modelSettings":{},"capabilities":{},"behavior":{},"identity":{},"skillIds":[""],"subAgentIds":[""],"knowledgeCollectionIds":[""],"databaseCollectionIds":[""],"databaseAccessPolicies":{},"starterPrompts":[""],"avatarUrl":"","tools":{"mode":"NORMAL","discoveryWhitelist":true,"pinnedSlugs":[""],"externalMcpConfigs":[""],"connectionCallbackUrl":"","visitorOwnerConnections":{"enabled":true,"toolkits":[]}},"inputSchema":{},"outputSchema":{}},"graph":{"nodes":[{"id":"","type":"action","toolSlug":"","inputMapping":{},"code":"","agent":{},"outputSchema":{}}],"edges":[{"from":"","to":"","condition":""}],"inputSchema":{},"outputSchema":{}},"provenance":{"createdByAgent":true,"productCreationDepth":0,"createdFromWorkflowId":"","hideFromAgentPicker":true,"marketplaceClone":{"sourceWorkflowId":"","clonedAt":"","skillIdMap":{},"knowledgeIdMap":{},"databaseIdMap":{},"subAgentIdMap":{},"avatarFileIdMap":{},"setupState":{"answers":{},"completedStepIds":[""]}}},"triggers":[{"kind":"manual","expression":"","timezone":"","toolSlug":"","triggerToolInput":{},"triggerId":"","toolkitName":"","toolkitLogo":""}],"workflowType":"static","isActive":true,"lifecycle":"draft","isPublic":true,"version":"","clonedFromWorkflowId":"","clonedFromVersion":"","executionCount":0,"successfulExecutionCount":0,"failedExecutionCount":0,"lastExecutedAt":"","connections":[{"id":"","connectionId":"","toolkitSlug":"","displayName":"","label":"","createdAt":"","updatedAt":""}],"tools":[{"toolSlug":"","toolName":"","toolkitName":"","toolkitLogo":""}],"subAgents":[""],"createdAt":"2024-01-01T00:00:00.000Z","updatedAt":"2024-01-01T00:00:00.000Z","sourceVersionLatest":"1.0.2","toolkitAuthConfigs":[{"toolkitSlug":"","authConfigId":"","name":"","authScheme":"","status":""}],"toolkitConnections":[{"toolkitSlug":"","connectedAccountId":"","displayName":"","label":"","status":"","authConfigId":""}],"marketplaceCategory":"","marketplaceAudience":"","marketplaceTagline":"","marketplaceSetupGuide":"","marketplaceSetupSpec":{},"marketplaceSetupSkillId":"","marketplaceSetupSkillSlug":"","marketplaceHighlights":[""],"marketplaceIsListed":true,"marketplaceCapabilities":{"hasSkills":true,"skillCount":0,"hasKnowledge":true,"hasDatabase":true,"hasCron":true,"requiresAuth":true,"toolkitCount":0,"subAgentCount":0,"toolCount":0}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"62185a36-a6c8-4d4f-bd7b-7438606ebe65":{"x-api-key":{"type":"apiKey","in":"header","name":"x-api-key","description":"Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: \u003cyour-key>","scopes":[],"schemeName":"x-api-key"}},"8a588f89-f0a7-4303-bc14-79a23bad2e3f":{"x-api-key":{"type":"apiKey","in":"header","name":"x-api-key","description":"Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: \u003cyour-key>","scopes":[],"schemeName":"x-api-key"},"x-username":{"type":"apiKey","in":"header","name":"x-username","description":"Optional. External user username. If omitted, Flowra uses the project’s default external user. Send as header: x-username: \u003cusername>","scopes":[],"schemeName":"x-username"}}},"servers":{"7d552b2e-a0a4-4310-b6db-55864d1e3c57":{"url":"https://flowra.dev","description":"Flowra API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: \u003cyour-key>","scopes":[],"schemeName":"x-api-key"},"schema":{"title":"x-api-key","type":"string","description":"Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: \u003cyour-key>","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-api-key","name":"x-api-key"}],"title":"x-api-key"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: \u003cyour-key>","scopes":[],"schemeName":"x-api-key"},"schema":{"title":"x-api-key","type":"string","description":"Project API key. Create and manage keys in the dashboard under Project → API Keys. Send as header: x-api-key: \u003cyour-key>","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-api-key","name":"x-api-key"},{"scheme":{"type":"apiKey","in":"header","name":"x-username","description":"Optional. External user username. If omitted, Flowra uses the project’s default external user. Send as header: x-username: \u003cusername>","scopes":[],"schemeName":"x-username"},"schema":{"title":"x-username","type":"string","description":"Optional. External user username. If omitted, Flowra uses the project’s default external user. Send as header: x-username: \u003cusername>","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-username","name":"x-username"}],"title":"x-api-key \u0026 x-username"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"flowra","siteName":"Flowra","title":"Create workflow (agent) - Flowra","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-11T07:54:24.277Z","originalFileLocation":"api-reference/workflow-\u0026-agent/create-workflow-agent.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Flowra\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/flowra/eRan3KqAEPA_p1_2/_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/flowra/eRan3KqAEPA_p1_2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/flowra/eRan3KqAEPA_p1_2/_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/flowra/eRan3KqAEPA_p1_2/_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/flowra/eRan3KqAEPA_p1_2/_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/flowra/eRan3KqAEPA_p1_2/_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/flowra/eRan3KqAEPA_p1_2/_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/flowra/eRan3KqAEPA_p1_2/_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/flowra/eRan3KqAEPA_p1_2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create workflow (agent) - Flowra\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Flowra\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.flowra.dev/api-reference/workflow-\u0026amp;-agent/create-workflow-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://flowra.mintlify.site/_mintlify/api/og/v2?division=Workflow+%26+Agent\u0026amp;title=Create+workflow+%28agent%29\u0026amp;description=Create+a+new+agent%2Fworkflow+with+name%2C+tools%2C+system+prompt%2C+and+model.+Can+be+triggered+manually+or+by+schedules%2Fwebhooks.\u0026amp;theme=29ac3032f80d74eeaee9365e\u0026amp;signature=2540c067cd41e64e8cd1a1ab73376250c190c868bb44b5a50c7d4416b6cdc5b6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create workflow (agent) - Flowra\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://flowra.mintlify.site/_mintlify/api/og/v2?division=Workflow+%26+Agent\u0026amp;title=Create+workflow+%28agent%29\u0026amp;description=Create+a+new+agent%2Fworkflow+with+name%2C+tools%2C+system+prompt%2C+and+model.+Can+be+triggered+manually+or+by+schedules%2Fwebhooks.\u0026amp;theme=29ac3032f80d74eeaee9365e\u0026amp;signature=2540c067cd41e64e8cd1a1ab73376250c190c868bb44b5a50c7d4416b6cdc5b6\">\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/flowra/eRan3KqAEPA_p1_2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Flowra\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#bb7400\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.flowra.dev/api-reference/workflow-\u0026amp;-agent/create-workflow-agent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/workflow-%26-agent/create-workflow-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://flowra.dev/#organization\",\"name\":\"Flowra\",\"url\":\"https://flowra.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.flowra.dev/logo/light-with-text.svg\"},\"sameAs\":[\"https://github.com/flowradev/sdk\",\"https://x.com/flowradev\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.flowra.dev#website\",\"name\":\"Flowra\",\"url\":\"https://docs.flowra.dev\",\"publisher\":{\"@id\":\"https://flowra.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent#webpage\",\"url\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent\",\"name\":\"Create workflow (agent)\",\"description\":\"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.\",\"dateModified\":\"2026-10-11T07:54:24.277Z\",\"isPartOf\":{\"@id\":\"https://docs.flowra.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workflow \u0026 Agent\",\"item\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/get-executions-for-a-specific-workflow\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create workflow (agent)\",\"item\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent#apireference\",\"headline\":\"Create workflow (agent)\",\"name\":\"Create workflow (agent)\",\"description\":\"Create a new agent/workflow with name, tools, system prompt, and model. Can be triggered manually or by schedules/webhooks.\",\"url\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent\",\"mainEntityOfPage\":{\"@id\":\"https://docs.flowra.dev/api-reference/workflow-\u0026-agent/create-workflow-agent#webpage\"},\"dateModified\":\"2026-10-11T07:54:24.277Z\",\"publisher\":{\"@id\":\"https://flowra.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.flowra.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Flowra\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Flowra","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"rectangle-terminal","href":"https://flowra.dev/dashboard"},{"anchor":"API","icon":"code","href":"/api-reference"},{"anchor":"SDK","icon":"cube","href":"/guides/sdk"}]},"tabs":[{"tab":"Product","pages":[{"title":"Product","href":""}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/quickstart"}]},{"tab":"API reference","groups":[{"group":"Users","pages":[{"title":"Get current user profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/users/profile","href":"/api-reference/users/get-current-user-profile"}]},{"group":"External Users","pages":[{"title":"List external users","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/external-users","href":"/api-reference/external-users/list-external-users"},{"title":"Create external user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/external-users","href":"/api-reference/external-users/create-external-user"},{"title":"Refresh external user profile photo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/external-users/{id}/refresh-avatar","href":"/api-reference/external-users/refresh-external-user-profile-photo"},{"title":"Toggle external user active status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /api/v1/external-users/{id}/toggle-active","href":"/api-reference/external-users/toggle-external-user-active-status"},{"title":"Get external user by username","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/external-users/username/{username}","href":"/api-reference/external-users/get-external-user-by-username"}]},{"group":"Auth Configs","pages":[{"title":"List auth configurations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/auth_configs","href":"/api-reference/auth-configs/list-auth-configurations"},{"title":"Create auth configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/auth_configs","href":"/api-reference/auth-configs/create-auth-configuration"},{"title":"Get auth configuration by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/auth_configs/{id}","href":"/api-reference/auth-configs/get-auth-configuration-by-id"},{"title":"Delete auth configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/auth_configs/{id}","href":"/api-reference/auth-configs/delete-auth-configuration"}]},{"group":"Connected Accounts","pages":[{"title":"List connected accounts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/connected_accounts","href":"/api-reference/connected-accounts/list-connected-accounts"},{"title":"Create connected account (provider dispatch)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/connected_accounts","href":"/api-reference/connected-accounts/create-connected-account-provider-dispatch"},{"title":"Delete a connected account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/connected_accounts/{id}","href":"/api-reference/connected-accounts/delete-a-connected-account"},{"title":"Update a connected account (e.g. display name)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/connected_accounts/{id}","href":"/api-reference/connected-accounts/update-a-connected-account-eg-display-name"},{"title":"List connections grouped by toolkit (dashboard)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/connected_accounts/grouped-by-toolkit","href":"/api-reference/connected-accounts/list-connections-grouped-by-toolkit-dashboard"},{"title":"Create a new auth link session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/connected_accounts/link","href":"/api-reference/connected-accounts/create-a-new-auth-link-session"}]},{"group":"Toolkits","pages":[{"title":"Get all toolkits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/toolkits","href":"/api-reference/toolkits/get-all-toolkits"},{"title":"Create a new toolkit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/toolkits","href":"/api-reference/toolkits/create-a-new-toolkit"},{"title":"Get toolkit by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/toolkits/byId/{id}","href":"/api-reference/toolkits/get-toolkit-by-id"},{"title":"Delete a toolkit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/toolkits/byId/{id}","href":"/api-reference/toolkits/delete-a-toolkit"},{"title":"Update an existing toolkit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/toolkits/byId/{id}","href":"/api-reference/toolkits/update-an-existing-toolkit"},{"title":"Set toolkit active status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/toolkits/byId/{id}/status","href":"/api-reference/toolkits/set-toolkit-active-status"},{"title":"Get public catalog toolkit by slug","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/toolkits/bySlug/{slug}","href":"/api-reference/toolkits/get-public-catalog-toolkit-by-slug"},{"title":"List toolkit categories","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/toolkits/categories","href":"/api-reference/toolkits/list-toolkit-categories"},{"title":"List messaging channels for agent entry points","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/toolkits/messaging-channels","href":"/api-reference/toolkits/list-messaging-channels-for-agent-entry-points"},{"title":"Get toolkits with nested tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/toolkits/with-tools","href":"/api-reference/toolkits/get-toolkits-with-nested-tools"}]},{"group":"Tools","pages":[{"title":"List available tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/tools","href":"/api-reference/tools/list-available-tools"},{"title":"Create a new tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/tools","href":"/api-reference/tools/create-a-new-tool"},{"title":"Get tool by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/tools/byId/{id}","href":"/api-reference/tools/get-tool-by-id"},{"title":"Delete a tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/tools/byId/{id}","href":"/api-reference/tools/delete-a-tool"},{"title":"Update an existing tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/tools/byId/{id}","href":"/api-reference/tools/update-an-existing-tool"},{"title":"Set tool active status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/tools/byId/{id}/status","href":"/api-reference/tools/set-tool-active-status"},{"title":"Execute tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/tools/execute/{toolSlug}","href":"/api-reference/tools/execute-tool"},{"title":"List tool execution logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/tools/execution-logs","href":"/api-reference/tools/list-tool-execution-logs"}]},{"group":"Skills","pages":[{"title":"Browse skill catalog","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/skills/catalog/browse","href":"/api-reference/skills/browse-skill-catalog"},{"title":"Create a custom skill","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/skills/create","href":"/api-reference/skills/create-a-custom-skill"},{"title":"Soft-delete a skill","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/skills/delete/{id}","href":"/api-reference/skills/soft-delete-a-skill"},{"title":"Get skill by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/skills/detail/{id}","href":"/api-reference/skills/get-skill-by-id"},{"title":"Import SKILL.md from GitHub URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/skills/import/github","href":"/api-reference/skills/import-skillmd-from-github-url"},{"title":"Add a platform/registry catalog skill to My Skills","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/skills/library/add/{id}","href":"/api-reference/skills/add-a-platformregistry-catalog-skill-to-my-skills"},{"title":"List My Skills","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/skills/list","href":"/api-reference/skills/list-my-skills"},{"title":"Install skill from registry / GitHub repo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/skills/registry/install","href":"/api-reference/skills/install-skill-from-registry-github-repo"},{"title":"List skills.sh leaderboard","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/skills/registry/list","href":"/api-reference/skills/list-skillssh-leaderboard"},{"title":"Search skills.sh registry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/skills/registry/search","href":"/api-reference/skills/search-skillssh-registry"},{"title":"Sync a registry skill from GitHub","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/skills/registry/sync/{id}","href":"/api-reference/skills/sync-a-registry-skill-from-github"},{"title":"Update a skill","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/skills/update/{id}","href":"/api-reference/skills/update-a-skill"}]},{"group":"Workflow \u0026 Agent","pages":[{"title":"Get executions for a specific workflow","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/workflow/manager/{id}/executions","href":"/api-reference/workflow-\u0026-agent/get-executions-for-a-specific-workflow"},{"title":"Get workflow/agent statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/workflow/manager/{id}/statistics","href":"/api-reference/workflow-\u0026-agent/get-workflowagent-statistics"},{"title":"Update workflow status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/workflow/manager/activeStatus/{id}","href":"/api-reference/workflow-\u0026-agent/update-workflow-status"},{"title":"Add connection after OAuth for a workflow","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/workflow/manager/add-connection","href":"/api-reference/workflow-\u0026-agent/add-connection-after-oauth-for-a-workflow"},{"title":"Change workflow connection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/workflow/manager/change-connection/{id}","href":"/api-reference/workflow-\u0026-agent/change-workflow-connection"},{"title":"Clear AuthConfig binding for a toolkit on an agent workflow","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/workflow/manager/clear-auth-config/{id}","href":"/api-reference/workflow-\u0026-agent/clear-authconfig-binding-for-a-toolkit-on-an-agent-workflow"},{"title":"Clear preferred connected account for a toolkit","description":"Removes the bound ConnectedAccount for a toolkit on this workflow. Used when disconnecting visitor owner-connections or cron owner binds.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/workflow/manager/clear-connection/{id}","href":"/api-reference/workflow-\u0026-agent/clear-preferred-connected-account-for-a-toolkit"},{"title":"Create workflow (agent)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/workflow/manager/create","href":"/api-reference/workflow-\u0026-agent/create-workflow-agent"},{"title":"Delete workflow","description":"Permanently removes a workflow. It can no longer be run or triggered.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/workflow/manager/delete/{id}","href":"/api-reference/workflow-\u0026-agent/delete-workflow"},{"title":"Get workflow detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/workflow/manager/detail/{id}","href":"/api-reference/workflow-\u0026-agent/get-workflow-detail"},{"title":"Trigger workflow execution manually","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/workflow/manager/execute/{id}","href":"/api-reference/workflow-\u0026-agent/trigger-workflow-execution-manually"},{"title":"Get workflow executions list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/workflow/manager/executions","href":"/api-reference/workflow-\u0026-agent/get-workflow-executions-list"},{"title":"Get workflow execution detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/workflow/manager/executions/{id}","href":"/api-reference/workflow-\u0026-agent/get-workflow-execution-detail"},{"title":"Resume workflow execution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/workflow/manager/executions/thread/{threadId}/resume","href":"/api-reference/workflow-\u0026-agent/resume-workflow-execution"},{"title":"Get execution status by thread ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/workflow/manager/executions/thread/{threadId}/status","href":"/api-reference/workflow-\u0026-agent/get-execution-status-by-thread-id"},{"title":"Get workflow list","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/workflow/manager/list","href":"/api-reference/workflow-\u0026-agent/get-workflow-list"},{"title":"Bind AuthConfig for a toolkit on an agent workflow","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/workflow/manager/set-auth-config/{id}","href":"/api-reference/workflow-\u0026-agent/bind-authconfig-for-a-toolkit-on-an-agent-workflow"},{"title":"Update workflow","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/workflow/manager/update/{id}","href":"/api-reference/workflow-\u0026-agent/update-workflow"}]},{"group":"Triggers","pages":[{"title":"Create or update trigger","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/trigger_instances/{slug}/upsert","href":"/api-reference/triggers/create-or-update-trigger"},{"title":"List active triggers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/trigger_instances/active","href":"/api-reference/triggers/list-active-triggers"},{"title":"List trigger invocation logs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/trigger_instances/invocation-logs","href":"/api-reference/triggers/list-trigger-invocation-logs"},{"title":"Replay trigger invocation as webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/trigger_instances/invocation-logs/{logId}/replay-webhook","href":"/api-reference/triggers/replay-trigger-invocation-as-webhook"},{"title":"Delete trigger","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/trigger_instances/manage/{triggerId}","href":"/api-reference/triggers/delete-trigger"},{"title":"Enable or disable trigger","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/trigger_instances/manage/{triggerId}/status","href":"/api-reference/triggers/enable-or-disable-trigger"}]},{"group":"Chat","pages":[{"title":"Create thread","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/graphify/threads","href":"/api-reference/chat/create-thread"},{"title":"Get thread","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/graphify/threads/{thread_id}","href":"/api-reference/chat/get-thread"},{"title":"Delete thread","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/graphify/threads/{thread_id}","href":"/api-reference/chat/delete-thread"},{"title":"Update thread","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/graphify/threads/{thread_id}","href":"/api-reference/chat/update-thread"},{"title":"Generate thread title","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/graphify/threads/{thread_id}/generate-title","href":"/api-reference/chat/generate-thread-title"},{"title":"Get thread history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/graphify/threads/{thread_id}/history","href":"/api-reference/chat/get-thread-history"},{"title":"Send operator channel reply","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/graphify/threads/{thread_id}/operator-reply","href":"/api-reference/chat/send-operator-channel-reply"},{"title":"Set channel reply mode","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/graphify/threads/{thread_id}/reply-mode","href":"/api-reference/chat/set-channel-reply-mode"},{"title":"List thread runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/graphify/threads/{thread_id}/runs","href":"/api-reference/chat/list-thread-runs"},{"title":"Cancel run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/graphify/threads/{thread_id}/runs/{run_id}/cancel","href":"/api-reference/chat/cancel-run"},{"title":"Join run stream","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/graphify/threads/{thread_id}/runs/{run_id}/stream","href":"/api-reference/chat/join-run-stream"},{"title":"Stream thread run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/graphify/threads/{thread_id}/runs/stream","href":"/api-reference/chat/stream-thread-run"},{"title":"Get thread state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/graphify/threads/{thread_id}/state","href":"/api-reference/chat/get-thread-state"},{"title":"Search threads","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/graphify/threads/search","href":"/api-reference/chat/search-threads"}]},{"group":"File","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/file","href":"/api-reference/file/list-files"},{"title":"Serve file by filename","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/file/{filename}","href":"/api-reference/file/serve-file-by-filename"},{"title":"Delete file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/file/{id}","href":"/api-reference/file/delete-file"},{"title":"Delete multiple files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/file/delete-many","href":"/api-reference/file/delete-multiple-files"},{"title":"Download file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/file/download/{id}","href":"/api-reference/file/download-file"},{"title":"Get file type info","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/file/fileType/{fileType}","href":"/api-reference/file/get-file-type-info"},{"title":"List supported file types","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/file/fileTypes","href":"/api-reference/file/list-supported-file-types"},{"title":"Delete oldest files to free storage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/file/prune-oldest","href":"/api-reference/file/delete-oldest-files-to-free-storage"},{"title":"File storage breakdown","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/file/storage-breakdown","href":"/api-reference/file/file-storage-breakdown"},{"title":"Upload a single file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/file/upload/single/{fileType}","href":"/api-reference/file/upload-a-single-file"}]},{"group":"Knowledge","pages":[{"title":"Get all RAG collections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge/collections","href":"/api-reference/knowledge/get-all-rag-collections"},{"title":"Create an empty knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge/collections","href":"/api-reference/knowledge/create-an-empty-knowledge-collection"},{"title":"Get knowledge collection details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge/collections/{id}","href":"/api-reference/knowledge/get-knowledge-collection-details"},{"title":"Delete knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/knowledge/collections/{id}","href":"/api-reference/knowledge/delete-knowledge-collection"},{"title":"Rename a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge/collections/{id}","href":"/api-reference/knowledge/rename-a-knowledge-collection"},{"title":"List chunks in a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge/collections/{id}/chunks","href":"/api-reference/knowledge/list-chunks-in-a-knowledge-collection"},{"title":"Toggle read-only share with project members via MCP","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge/collections/{id}/expose-mcp","href":"/api-reference/knowledge/toggle-read-only-share-with-project-members-via-mcp"},{"title":"Add an uploaded file to a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge/collections/{id}/ingest/file","href":"/api-reference/knowledge/add-an-uploaded-file-to-a-knowledge-collection"},{"title":"Add pasted text to a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge/collections/{id}/ingest/text","href":"/api-reference/knowledge/add-pasted-text-to-a-knowledge-collection"},{"title":"Add a web page to a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge/collections/{id}/ingest/url","href":"/api-reference/knowledge/add-a-web-page-to-a-knowledge-collection"},{"title":"Semantic search within a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge/collections/{id}/search","href":"/api-reference/knowledge/semantic-search-within-a-knowledge-collection"},{"title":"List sources in a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge/collections/{id}/sources","href":"/api-reference/knowledge/list-sources-in-a-knowledge-collection"},{"title":"Delete a source from a knowledge collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/knowledge/collections/{id}/sources","href":"/api-reference/knowledge/delete-a-source-from-a-knowledge-collection"}]},{"group":"Table","pages":[{"title":"List collections","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/table/collections","href":"/api-reference/table/list-collections"},{"title":"Create document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/table/collections/{collectionId}/documents","href":"/api-reference/table/create-document"},{"title":"Delete document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/table/collections/{collectionId}/documents/{documentId}","href":"/api-reference/table/delete-document"},{"title":"Update document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/table/collections/{collectionId}/documents/{documentId}","href":"/api-reference/table/update-document"},{"title":"Get collection metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/table/collections/{id}","href":"/api-reference/table/get-collection-metadata"},{"title":"Delete collection","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/table/collections/{id}","href":"/api-reference/table/delete-collection"},{"title":"List collection documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/table/collections/{id}/documents","href":"/api-reference/table/list-collection-documents"},{"title":"Toggle read-only share with project members via MCP","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/table/collections/{id}/expose-mcp","href":"/api-reference/table/toggle-read-only-share-with-project-members-via-mcp"}]},{"group":"Sandbox","pages":[{"title":"Run code in an ephemeral sandbox","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sandbox/ephemeral","href":"/api-reference/sandbox/run-code-in-an-ephemeral-sandbox"},{"title":"Create a durable sandbox session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sandbox/sessions","href":"/api-reference/sandbox/create-a-durable-sandbox-session"},{"title":"Get sandbox session status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/sandbox/sessions/{id}","href":"/api-reference/sandbox/get-sandbox-session-status"},{"title":"Release a sandbox session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/sandbox/sessions/{id}","href":"/api-reference/sandbox/release-a-sandbox-session"},{"title":"Execute code in a sandbox session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sandbox/sessions/{id}/execute","href":"/api-reference/sandbox/execute-code-in-a-sandbox-session"},{"title":"Chat computer status for a thread","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/sandbox/threads/{threadId}","href":"/api-reference/sandbox/chat-computer-status-for-a-thread"},{"title":"Power off chat computer for a thread","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/sandbox/threads/{threadId}","href":"/api-reference/sandbox/power-off-chat-computer-for-a-thread"},{"title":"Warm-start chat computer for a thread","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sandbox/threads/{threadId}/start","href":"/api-reference/sandbox/warm-start-chat-computer-for-a-thread"}]},{"group":"Browser","pages":[{"title":"Close live browser session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/browser/sessions/{sessionId}/close","href":"/api-reference/browser/close-live-browser-session"},{"title":"Browser session status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/browser/sessions/{sessionId}/status","href":"/api-reference/browser/browser-session-status"},{"title":"Heartbeat for open browser panel","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/browser/sessions/{sessionId}/touch","href":"/api-reference/browser/heartbeat-for-open-browser-panel"},{"title":"Live browser panel (iframe)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/browser/sessions/{sessionId}/view","href":"/api-reference/browser/live-browser-panel-iframe"}]},{"group":"LLM","pages":[{"title":"Chat with conversation history","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/ai/llm/chat","href":"/api-reference/llm/chat-with-conversation-history"},{"title":"Generate text","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/ai/llm/generate","href":"/api-reference/llm/generate-text"},{"title":"","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/ai/models","href":"/api-reference/llm/get-apiv1aimodels"}]},{"group":"MCP","pages":[{"title":"Hosted MCP SSE endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/mcp","href":"/api-reference/mcp/hosted-mcp-sse-endpoint"},{"title":"Hosted MCP JSON-RPC endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/mcp","href":"/api-reference/mcp/hosted-mcp-json-rpc-endpoint"},{"title":"List MCP servers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/mcp_manager","href":"/api-reference/mcp/list-mcp-servers"},{"title":"Create a new MCP server","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/mcp_manager","href":"/api-reference/mcp/create-a-new-mcp-server"},{"title":"Get MCP server by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/mcp_manager/{id}","href":"/api-reference/mcp/get-mcp-server-by-id"},{"title":"Delete MCP server","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/mcp_manager/{id}","href":"/api-reference/mcp/delete-mcp-server"},{"title":"Update MCP server","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/mcp_manager/{id}","href":"/api-reference/mcp/update-mcp-server"},{"title":"Get MCP server config (tools list)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/mcp_manager/{id}/config","href":"/api-reference/mcp/get-mcp-server-config-tools-list"},{"title":"Clear AuthConfig binding for a toolkit on an MCP server","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/mcp_manager/clear-auth-config/{id}","href":"/api-reference/mcp/clear-authconfig-binding-for-a-toolkit-on-an-mcp-server"},{"title":"Bind AuthConfig for a toolkit on an MCP server","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/mcp_manager/set-auth-config/{id}","href":"/api-reference/mcp/bind-authconfig-for-a-toolkit-on-an-mcp-server"},{"title":"MCP SSE endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/mcp/{serverId}","href":"/api-reference/mcp/mcp-sse-endpoint"},{"title":"MCP JSON-RPC endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/mcp/{serverId}","href":"/api-reference/mcp/mcp-json-rpc-endpoint"},{"title":"Agent as MCP SSE endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/mcp/agents/{agentId}","href":"/api-reference/mcp/agent-as-mcp-sse-endpoint"},{"title":"Agent as MCP JSON-RPC endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/mcp/agents/{agentId}","href":"/api-reference/mcp/agent-as-mcp-json-rpc-endpoint"}]},{"group":"usage","pages":[{"title":"Credit usage ledger (API key)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/usage","href":"/api-reference/usage/credit-usage-ledger-api-key"},{"title":"Credit balance (API key)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/usage/balance","href":"/api-reference/usage/credit-balance-api-key"},{"title":"Usage for one execution","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/usage/executions/{executionId}","href":"/api-reference/usage/usage-for-one-execution"}]}]}]},"basePath":"","title":"Create workflow (agent) - Flowra","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}