{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Kadoa Documentation","colors":{"primary":"#ea580c","light":"#ea580c","dark":"#18181b"},"logo":{"light":"https://mintcdn.com/kadoa/dCOYM0EuffD9qYID/logo/kadoa-logo.svg?fit=max\u0026auto=format\u0026n=dCOYM0EuffD9qYID\u0026q=85\u0026s=344d5ae11cb3c2519a3c1541507ebed5","dark":"https://mintcdn.com/kadoa/dCOYM0EuffD9qYID/logo/kadoa-logo-dark.svg?fit=max\u0026auto=format\u0026n=dCOYM0EuffD9qYID\u0026q=85\u0026s=1fea0a0ce836a0d67d103f5e5adb6dda"},"favicon":"https://mintcdn.com/kadoa/A3sRkEG_6lnlmZD1/favicon.svg?fit=max\u0026auto=format\u0026n=A3sRkEG_6lnlmZD1\u0026q=85\u0026s=0cea8dbdde871424c4f413c68961c6e2","api":{"openapi":"https://api.kadoa.com/openapi"},"appearance":{"default":"light"},"background":{"color":{"light":"#fafaf9","dark":"#18181b"}},"navbar":{"primary":{"type":"button","label":"Open app","href":"https://kadoa.com/dashboard"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/kadoa","github":"https://github.com/kadoa-org"}},"seo":{"indexing":"all"},"fonts":{"family":"Kadoa Sans","weight":360,"source":"https://kadoa.b-cdn.net/fonts/KadoaSans-Variable.woff2","format":"woff2"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":{"style":"duotone","name":"clock-rotate-left"},"href":"https://www.kadoa.com/changelog"},{"anchor":"Trust Center","icon":{"style":"duotone","name":"shield-check"},"href":"https://trust.kadoa.com"},{"anchor":"Contact Us","icon":{"style":"duotone","name":"envelope"},"href":"https://www.kadoa.com/contact"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kadoa","hasAudioNarration":false,"actualSubdomain":"kadoa","customDomains":["docs.kadoa.com"],"gitSource":{"type":"github","owner":"kadoa-org","repo":"kadoa-backend","deployBranch":"main","contentDirectory":"docs/public","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af456db087b7a509954c49d","clientVersion":"0.0.4124","searchFilterCounts":[{"language":"default","tag":"API Reference","count":152},{"language":"default","tag":"Documentation","count":65},{"language":"default","tag":"Workflows","count":20},{"language":"default","tag":"Build workflows","count":20},{"language":"default","tag":"Templates","count":16},{"language":"default","tag":"Notifications","count":13},{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"Agent","count":9},{"language":"default","tag":"Variables","count":7},{"language":"default","tag":"Administration","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html,body{font-weight:380}strong,.link,.font-semibold,.font-bold{font-weight:520}.sidebar-group-header,.sidebar-title{color:rgb(var(--primary));font-weight:600}body:has(.landing-cards) #page-title{font-size:2.5rem;line-height:1.15}.landing-cards{gap:1rem}.landing-cards a.card{margin:0;border-radius:0.625rem;height:100%}.landing-cards a.card [data-component-part=\"card-content-container\"]{padding:0;display:flex;flex-direction:column;height:100%}.landing-cards a.card [data-component-part=\"card-icon\"]{margin:1.25rem 1.25rem 3.5rem}.landing-cards a.card [data-component-part=\"card-content-container\"]>div:has([data-component-part=\"card-title\"]){flex:1;border-top:1px solid rgb(9 9 11 / 0.08)}.landing-cards a.card [data-component-part=\"card-title\"]{margin:0;padding:1rem 1.25rem 0}.landing-cards a.card [data-component-part=\"card-content\"]{margin:0;padding:0.25rem 1.25rem 1.25rem;font-size:0.9375rem;line-height:1.45}.dark .landing-cards a.card [data-component-part=\"card-content-container\"]>div:has([data-component-part=\"card-title\"]){border-top-color:rgb(255 255 255 / 0.1)}body:has(.landing-cards) #content-area{max-width:68rem}.concept-list{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));column-gap:2.5rem;margin-top:1rem}.concept-list a{display:block;padding:0.875rem 0;border-top:1px solid rgb(9 9 11 / 0.08);text-decoration:none}.concept-name{display:block;color:rgb(24 24 27);font-weight:520}.concept-desc{display:block;margin-top:0.125rem;color:rgb(113 113 122);font-size:0.9375rem;line-height:1.45}.concept-list a:hover .concept-name,.concept-list a:focus-visible .concept-name{color:rgb(var(--primary))}.concept-list a:focus-visible{outline:2px solid rgb(var(--primary));outline-offset:2px;border-radius:0.25rem}.dark .concept-list a{border-top-color:rgb(255 255 255 / 0.1)}.dark .concept-name{color:rgb(244 244 245)}.dark .concept-desc{color:rgb(161 161 170)}@media (max-width: 640px){.concept-list{grid-template-columns:minmax(0, 1fr)}}@media (min-width: 640px) and (max-width: 1279px){.landing-cards{--cols: 2 !important}}.dark img[src$=\"/images/logos/openai.svg\"],.dark img[src$=\"/images/logos/cursor.svg\"],.dark img[src$=\"/images/logos/mcp.svg\"]{filter:invert(1)}"}],"page":{"pagePath":"api-reference/templates/create-version","slug":"/api-reference/templates/create-version","pageMetadata":{"title":"Create template version","description":"Publish a new version of a template with prompt, schema, validation, and notification settings","openapi":"post /v4/templates/{templateId}/versions","href":"/api-reference/templates/create-version"},"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: \"Publish a new version of a template with prompt, schema, validation, and notification settings\"\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 template version","description":"Publish a new version of a template with prompt, schema, validation, and notification settings","openapi":"post /v4/templates/{templateId}/versions","href":"/api-reference/templates/create-version"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/kadoa/c67f9ac954426fc4/fonts.js"],"openApiReferenceData":{"operation":{"description":"Publish a new version of a template with prompt, schema, validation, and notification settings","summary":"Publish template version","tags":["Templates"],"parameters":["de7acf5f-3002-459a-bf88-4b413809c6f7"],"requestBody":"8f246451-a8d0-4d42-a70a-d2a29ad1b819","responses":{"201":"3adc53e2-40d4-469d-96f9-12e5962b0193","400":"8d7707aa-9bfa-4b7e-ad73-a426dc46de10","401":"f445300e-3b6f-440c-8afc-fbba1b4c0459","404":"c6ee7113-8e80-4498-83d7-b2509f5bff51","500":"e255e0f4-c458-4b6c-b90d-94d23d456692"},"security":["f3934c2a-143f-41c5-a9c6-d1950c3e0cdb"],"method":"post","type":"path","servers":["8eaffad7-10ff-4cf4-a47e-9e49a75e3a9b"],"path":"/v4/templates/{templateId}/versions","baseUrlOptions":["https://api.kadoa.com"],"title":"Publish template version","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"de7acf5f-3002-459a-bf88-4b413809c6f7":{"name":"templateId","in":"path","description":"Template ID","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","isRequired":true,"description":"Template ID","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"description":"Body","content":{"application/json":{"schema":{"title":"CreateTemplateVersionBody","description":"Publish a complete immutable template snapshot. Omitted components inherit from the preceding version; null explicitly clears a component.","type":"object","properties":{"prompt":{"oneOf":[{"description":"Prompt; omit to inherit, null to clear","type":"string","uniqueKey":"prompt.oneOf.0","typeLabel":"string"},{"description":"Prompt; omit to inherit, null to clear","type":"null","uniqueKey":"prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"prompt","typeLabel":"string | null"},"schemaId":{"oneOf":[{"description":"Schema ID; omit to inherit, null to clear (mutually exclusive with schemaFields)","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","uniqueKey":"schemaId.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"Schema ID; omit to inherit, null to clear (mutually exclusive with schemaFields)","type":"null","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","uniqueKey":"schemaId.oneOf.1","typeLabel":"null"}],"uniqueKey":"schemaId","typeLabel":"string\u003cuuid> | null"},"schemaFields":{"oneOf":[{"description":"Inline schema fields; omit to inherit, null to clear","type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Field name","isRequired":true,"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].name","typeLabel":"string"},"mapper":{"description":"Function that produces this field's value.","type":"string","enum":["jobDescription","categoryClassifier","taxonomyMapping","stableUniqueId","linkExtraction","additionalData","categorize"],"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].mapper","typeLabel":"enum\u003cstring>"},"mapperConfig":{"description":"Configuration for the selected mapper.","type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].mapperConfig.additionalProperties","typeLabel":"any"},"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].mapperConfig","typeLabel":"object"},"description":{"description":"Human-readable field description shown in Kadoa","type":"string","uniqueKey":"schemaFields.oneOf.0.items.[INDEX].description","typeLabel":"string"},"instruction":{"description":"Separate extraction guidance for legacy authoring. In consolidated workflow mode, put guidance in description instead.","type":"string","uniqueKey":"schemaFields.oneOf.0.items.[INDEX].instruction","typeLabel":"string"},"fieldType":{"description":"Field role (SCHEMA or CLASSIFICATION)","type":"string","uniqueKey":"schemaFields.oneOf.0.items.[INDEX].fieldType","typeLabel":"string"},"example":{"description":"Separate sample values for legacy authoring. In consolidated workflow mode, use description for samples and shape for required OBJECT/ARRAY structure.","uniqueKey":"schemaFields.oneOf.0.items.[INDEX].example","typeLabel":"any"},"shape":{"description":"Authoritative nested shape for OBJECT/ARRAY fields; without it, a JSON object/array example is promoted to the enforced shape at workflow creation.","uniqueKey":"schemaFields.oneOf.0.items.[INDEX].shape","typeLabel":"any"},"dataType":{"description":"Output data type for SCHEMA fields. Use public values such as STRING, NUMBER, BOOLEAN, DATE, DATETIME, MONEY, IMAGE, LINK, OBJECT, or ARRAY.","type":"string","uniqueKey":"schemaFields.oneOf.0.items.[INDEX].dataType","typeLabel":"string"},"isKey":{"description":"Marks this field as part of the record's primary key. Key fields define row identity across runs and enable data linking (records with the same key values are treated as the same record over time, used for dedupe and change detection). Set true ONLY when the complete key tuple uniquely identifies a logical output record and every component is stable across runs and reliably present (not nullable/missing). Key fields should be scalar STRING, NUMBER, or LINK fields; avoid structured, semantic, boolean, image, and timestamp/date fields as keys. Good candidates: external IDs, SKUs, canonical URLs, posting IDs. Bad candidates: prices, counts, timestamps, free-text titles/descriptions, or anything that can change between runs. Multiple fields may form a composite key; uniqueness applies to their combination, not each component. For derived rows, source-backed grouping dimensions and a deterministic output discriminator may identify the result; measured values and explanations do not. If no supported key tuple satisfies these guarantees, leave isKey unset on every field — data linking will simply be disabled, which is preferable to a wrong key. Choosing a non-stable or non-unique key causes duplicate rows and missed updates.","type":"boolean","uniqueKey":"schemaFields.oneOf.0.items.[INDEX].isKey","typeLabel":"boolean"},"categories":{"description":"Predefined categories for CLASSIFICATION fields","type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Short title/label of the category","isRequired":true,"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].categories.items.[INDEX].title","typeLabel":"string"},"definition":{"type":"string","description":"Full definition/description of the category","isRequired":true,"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].categories.items.[INDEX].definition","typeLabel":"string"}},"required":["title","definition"],"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].categories.items.[INDEX]","typeLabel":"object"},"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].categories","typeLabel":"object[]"}},"required":["name"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"schemaFields.oneOf.0.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"schemaFields.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"schemaFields.oneOf.0","typeLabel":"object[]"},{"description":"Inline schema fields; omit to inherit, null to clear","type":"null","items":{"type":"object","properties":{"mapper":{"description":"Function that produces this field's value.","type":"string","enum":["jobDescription","categoryClassifier","taxonomyMapping","stableUniqueId","linkExtraction","additionalData","categorize"]},"mapperConfig":{"description":"Configuration for the selected mapper.","type":"object","additionalProperties":{"oneOf":[{}]}},"name":{"type":"string","description":"Field name"},"description":{"description":"Human-readable field description shown in Kadoa","type":"string"},"instruction":{"description":"Separate extraction guidance for legacy authoring. In consolidated workflow mode, put guidance in description instead.","type":"string"},"fieldType":{"description":"Field role (SCHEMA or CLASSIFICATION)","type":"string"},"example":{"description":"Separate sample values for legacy authoring. In consolidated workflow mode, use description for samples and shape for required OBJECT/ARRAY structure."},"shape":{"description":"Authoritative nested shape for OBJECT/ARRAY fields; without it, a JSON object/array example is promoted to the enforced shape at workflow creation."},"dataType":{"description":"Output data type for SCHEMA fields. Use public values such as STRING, NUMBER, BOOLEAN, DATE, DATETIME, MONEY, IMAGE, LINK, OBJECT, or ARRAY.","type":"string"},"isKey":{"description":"Marks this field as part of the record's primary key. Key fields define row identity across runs and enable data linking (records with the same key values are treated as the same record over time, used for dedupe and change detection). Set true ONLY when the complete key tuple uniquely identifies a logical output record and every component is stable across runs and reliably present (not nullable/missing). Key fields should be scalar STRING, NUMBER, or LINK fields; avoid structured, semantic, boolean, image, and timestamp/date fields as keys. Good candidates: external IDs, SKUs, canonical URLs, posting IDs. Bad candidates: prices, counts, timestamps, free-text titles/descriptions, or anything that can change between runs. Multiple fields may form a composite key; uniqueness applies to their combination, not each component. For derived rows, source-backed grouping dimensions and a deterministic output discriminator may identify the result; measured values and explanations do not. If no supported key tuple satisfies these guarantees, leave isKey unset on every field — data linking will simply be disabled, which is preferable to a wrong key. Choosing a non-stable or non-unique key causes duplicate rows and missed updates.","type":"boolean"},"categories":{"description":"Predefined categories for CLASSIFICATION fields","type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Short title/label of the category"},"definition":{"type":"string","description":"Full definition/description of the category"}},"required":["title","definition"]}}},"required":["name"],"additionalProperties":{"oneOf":[{}]}},"uniqueKey":"schemaFields.oneOf.1","typeLabel":"null"}],"uniqueKey":"schemaFields","typeLabel":"object[] | null"},"schemaEntity":{"description":"Entity name for supplied inline schema fields","type":"string","uniqueKey":"schemaEntity","typeLabel":"string"},"schemaValidationRules":{"oneOf":[{"description":"Rules; omit to inherit rules for fields retained by a replacement schema, null to clear, {} to manage an empty ruleset","type":"object","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"schemaValidationRules.oneOf.0.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"schemaValidationRules.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"schemaValidationRules.oneOf.0","typeLabel":"object"},{"description":"Rules; omit to inherit rules for fields retained by a replacement schema, null to clear, {} to manage an empty ruleset","type":"null","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"schemaValidationRules.oneOf.1.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"schemaValidationRules.oneOf.1.additionalProperties","typeLabel":"object"},"uniqueKey":"schemaValidationRules.oneOf.1","typeLabel":"null"}],"uniqueKey":"schemaValidationRules","typeLabel":"object | null"},"notifications":{"oneOf":[{"description":"Notifications; omit to inherit, null or [] to clear","type":"array","items":{"type":"object","properties":{"eventType":{"type":"string","isRequired":true,"uniqueKey":"notifications.oneOf.0.items.[INDEX].eventType","typeLabel":"string"},"eventConfiguration":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"notifications.oneOf.0.items.[INDEX].eventConfiguration.additionalProperties","typeLabel":"any"},"uniqueKey":"notifications.oneOf.0.items.[INDEX].eventConfiguration","typeLabel":"object"},"enabled":{"type":"boolean","uniqueKey":"notifications.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean"},"channelIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","uniqueKey":"notifications.oneOf.0.items.[INDEX].channelIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"notifications.oneOf.0.items.[INDEX].channelIds","typeLabel":"string\u003cuuid>[]"},"channels":{"type":"array","items":{"type":"object","properties":{"channelId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","isRequired":true,"uniqueKey":"notifications.oneOf.0.items.[INDEX].channels.items.[INDEX].channelId","typeLabel":"string\u003cuuid>"}},"required":["channelId"],"uniqueKey":"notifications.oneOf.0.items.[INDEX].channels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"notifications.oneOf.0.items.[INDEX].channels","typeLabel":"object[]"}},"required":["eventType"],"uniqueKey":"notifications.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"notifications.oneOf.0","typeLabel":"object[]"},{"description":"Notifications; omit to inherit, null or [] to clear","type":"null","items":{"type":"object","properties":{"eventType":{"type":"string"},"eventConfiguration":{"type":"object","additionalProperties":{"oneOf":[{}]}},"enabled":{"type":"boolean"},"channelIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"channels":{"type":"array","items":{"type":"object","properties":{"channelId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"required":["channelId"]}}},"required":["eventType"]},"uniqueKey":"notifications.oneOf.1","typeLabel":"null"}],"uniqueKey":"notifications","typeLabel":"object[] | null"},"frequency":{"oneOf":[{"description":"Frequency; omit to inherit, null to clear","type":"object","properties":{"interval":{"description":"Update interval enum (HOURLY/DAILY/CUSTOM/...). When CUSTOM, schedules must be provided.","type":"string","enum":["ONLY_ONCE","EVERY_10_MINUTES","EVERY_20_MINUTES","HALF_HOURLY","HOURLY","TWO_HOURLY","THREE_HOURLY","FOUR_HOURLY","SIX_HOURLY","TWELVE_HOURLY","EIGHTEEN_HOURLY","DAILY","TWO_DAY","THREE_DAY","WEEKLY","BIWEEKLY","TRIWEEKLY","FOUR_WEEKS","MONTHLY","CUSTOM"],"uniqueKey":"frequency.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"schedules":{"description":"Cron/repeat schedule specs. Required when interval=CUSTOM.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["repeat","cron"],"description":"Schedule type","isRequired":true,"uniqueKey":"frequency.oneOf.0.schedules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"interval":{"description":"Repeat token (e.g., '1h', '1d') when type=repeat","type":"string","uniqueKey":"frequency.oneOf.0.schedules.items.[INDEX].interval","typeLabel":"string"},"expressions":{"description":"Cron expressions when type=cron","type":"array","items":{"type":"string","uniqueKey":"frequency.oneOf.0.schedules.items.[INDEX].expressions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"frequency.oneOf.0.schedules.items.[INDEX].expressions","typeLabel":"string[]"},"timezone":{"description":"IANA timezone for cron expressions (e.g. 'America/New_York'). Defaults to UTC.","type":"string","uniqueKey":"frequency.oneOf.0.schedules.items.[INDEX].timezone","typeLabel":"string"}},"required":["type"],"uniqueKey":"frequency.oneOf.0.schedules.items.[INDEX]","typeLabel":"object"},"uniqueKey":"frequency.oneOf.0.schedules","typeLabel":"object[]"},"weekdaysOnly":{"description":"Skip runs that fall on Saturday or Sunday. Applies only to repeat intervals; for cron, set the weekdays in the expression.","type":"boolean","uniqueKey":"frequency.oneOf.0.weekdaysOnly","typeLabel":"boolean"}},"uniqueKey":"frequency.oneOf.0","typeLabel":"object"},{"description":"Frequency; omit to inherit, null to clear","type":"null","properties":{"interval":{"description":"Update interval enum (HOURLY/DAILY/CUSTOM/...). When CUSTOM, schedules must be provided.","type":"string","enum":["ONLY_ONCE","EVERY_10_MINUTES","EVERY_20_MINUTES","HALF_HOURLY","HOURLY","TWO_HOURLY","THREE_HOURLY","FOUR_HOURLY","SIX_HOURLY","TWELVE_HOURLY","EIGHTEEN_HOURLY","DAILY","TWO_DAY","THREE_DAY","WEEKLY","BIWEEKLY","TRIWEEKLY","FOUR_WEEKS","MONTHLY","CUSTOM"]},"schedules":{"description":"Cron/repeat schedule specs. Required when interval=CUSTOM.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["repeat","cron"],"description":"Schedule type"},"interval":{"description":"Repeat token (e.g., '1h', '1d') when type=repeat","type":"string"},"expressions":{"description":"Cron expressions when type=cron","type":"array","items":{"type":"string"}},"timezone":{"description":"IANA timezone for cron expressions (e.g. 'America/New_York'). Defaults to UTC.","type":"string"}},"required":["type"]}},"weekdaysOnly":{"description":"Skip runs that fall on Saturday or Sunday. Applies only to repeat intervals; for cron, set the weekdays in the expression.","type":"boolean"}},"uniqueKey":"frequency.oneOf.1","typeLabel":"null"}],"uniqueKey":"frequency","typeLabel":"object | null"},"recordLimit":{"oneOf":[{"description":"Output record limit; omit to inherit, null for template-managed unlimited","type":"integer","minimum":1,"maximum":2147483647,"uniqueKey":"recordLimit.oneOf.0","typeLabel":"integer"},{"description":"Output record limit; omit to inherit, null for template-managed unlimited","type":"null","minimum":1,"maximum":2147483647,"uniqueKey":"recordLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"recordLimit","typeLabel":"integer | null"},"recordLimitManaged":{"description":"False clears template ownership of the output record limit","type":"boolean","enum":[false],"uniqueKey":"recordLimitManaged","typeLabel":"enum\u003cboolean>"}},"uniqueKey":"","typeLabel":"CreateTemplateVersionBody · object"},"examples":{"Example":{"title":"Example","value":{"prompt":"\u003cstring>","schemaId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","schemaFields":[{"name":"\u003cstring>","mapperConfig":{},"description":"\u003cstring>","instruction":"\u003cstring>","fieldType":"\u003cstring>","example":"\u003cunknown>","shape":"\u003cunknown>","dataType":"\u003cstring>","isKey":true,"categories":[{"title":"\u003cstring>","definition":"\u003cstring>"}]}],"schemaEntity":"\u003cstring>","schemaValidationRules":{},"notifications":[{"eventType":"\u003cstring>","eventConfiguration":{},"enabled":true,"channelIds":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"channels":[{"channelId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}]}],"frequency":{"schedules":[{"interval":"\u003cstring>","expressions":["\u003cstring>"],"timezone":"\u003cstring>"}],"weekdaysOnly":true},"recordLimit":1073741824,"recordLimitManaged":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3adc53e2-40d4-469d-96f9-12e5962b0193":{"description":"Response for template version create/update","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","enum":[false],"description":"Error flag (always false on success)","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cboolean>"},"success":{"type":"boolean","enum":[true],"description":"Success flag","isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Version row ID","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"templateId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Parent template ID","isRequired":true,"uniqueKey":"data.templateId","typeLabel":"string\u003cuuid>"},"version":{"type":"number","description":"Version number","isRequired":true,"uniqueKey":"data.version","typeLabel":"number"},"name":{"oneOf":[{"description":"Custom display name (null = default 'v.N')","type":"string","isRequired":true,"uniqueKey":"data.name.oneOf.0","typeLabel":"string"},{"description":"Custom display name (null = default 'v.N')","type":"null","isRequired":true,"uniqueKey":"data.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.name","typeLabel":"string | null"},"publisher":{"type":"object","properties":{"kind":{"oneOf":[{"description":"Publisher kind; null for legacy/unproven versions","type":"string","enum":["HUMAN","SERVICE_ACCOUNT","AGENT","SYSTEM"],"isRequired":true,"uniqueKey":"data.publisher.kind.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Publisher kind; null for legacy/unproven versions","type":"null","enum":["HUMAN","SERVICE_ACCOUNT","AGENT","SYSTEM"],"isRequired":true,"uniqueKey":"data.publisher.kind.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.publisher.kind","typeLabel":"enum\u003cstring> | null"},"label":{"type":"string","description":"Current human name/email, non-human publisher label, or Unknown for legacy/unproven versions","isRequired":true,"uniqueKey":"data.publisher.label","typeLabel":"string"}},"required":["kind","label"],"title":"TemplateVersionPublisher","description":"Publisher attribution","isRequired":true,"uniqueKey":"data.publisher","typeLabel":"TemplateVersionPublisher · object"},"prompt":{"oneOf":[{"description":"User prompt","type":"string","isRequired":true,"uniqueKey":"data.prompt.oneOf.0","typeLabel":"string"},{"description":"User prompt","type":"null","isRequired":true,"uniqueKey":"data.prompt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.prompt","typeLabel":"string | null"},"schemaId":{"oneOf":[{"description":"Referenced data_schemas ID","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","isRequired":true,"uniqueKey":"data.schemaId.oneOf.0","typeLabel":"string\u003cuuid>"},{"description":"Referenced data_schemas ID","type":"null","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","isRequired":true,"uniqueKey":"data.schemaId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.schemaId","typeLabel":"string\u003cuuid> | null"},"frequency":{"oneOf":[{"description":"Frequency configuration for this version","type":"object","properties":{"interval":{"description":"Update interval enum (HOURLY/DAILY/CUSTOM/...). When CUSTOM, schedules must be provided.","type":"string","enum":["ONLY_ONCE","EVERY_10_MINUTES","EVERY_20_MINUTES","HALF_HOURLY","HOURLY","TWO_HOURLY","THREE_HOURLY","FOUR_HOURLY","SIX_HOURLY","TWELVE_HOURLY","EIGHTEEN_HOURLY","DAILY","TWO_DAY","THREE_DAY","WEEKLY","BIWEEKLY","TRIWEEKLY","FOUR_WEEKS","MONTHLY","CUSTOM"],"uniqueKey":"data.frequency.oneOf.0.interval","typeLabel":"enum\u003cstring>"},"schedules":{"description":"Cron/repeat schedule specs. Required when interval=CUSTOM.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["repeat","cron"],"description":"Schedule type","isRequired":true,"uniqueKey":"data.frequency.oneOf.0.schedules.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"interval":{"description":"Repeat token (e.g., '1h', '1d') when type=repeat","type":"string","uniqueKey":"data.frequency.oneOf.0.schedules.items.[INDEX].interval","typeLabel":"string"},"expressions":{"description":"Cron expressions when type=cron","type":"array","items":{"type":"string","uniqueKey":"data.frequency.oneOf.0.schedules.items.[INDEX].expressions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.frequency.oneOf.0.schedules.items.[INDEX].expressions","typeLabel":"string[]"},"timezone":{"description":"IANA timezone for cron expressions (e.g. 'America/New_York'). Defaults to UTC.","type":"string","uniqueKey":"data.frequency.oneOf.0.schedules.items.[INDEX].timezone","typeLabel":"string"}},"required":["type"],"uniqueKey":"data.frequency.oneOf.0.schedules.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.frequency.oneOf.0.schedules","typeLabel":"object[]"},"weekdaysOnly":{"description":"Skip runs that fall on Saturday or Sunday. Applies only to repeat intervals; for cron, set the weekdays in the expression.","type":"boolean","uniqueKey":"data.frequency.oneOf.0.weekdaysOnly","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"data.frequency.oneOf.0","typeLabel":"object"},{"description":"Frequency configuration for this version","type":"null","properties":{"interval":{"description":"Update interval enum (HOURLY/DAILY/CUSTOM/...). When CUSTOM, schedules must be provided.","type":"string","enum":["ONLY_ONCE","EVERY_10_MINUTES","EVERY_20_MINUTES","HALF_HOURLY","HOURLY","TWO_HOURLY","THREE_HOURLY","FOUR_HOURLY","SIX_HOURLY","TWELVE_HOURLY","EIGHTEEN_HOURLY","DAILY","TWO_DAY","THREE_DAY","WEEKLY","BIWEEKLY","TRIWEEKLY","FOUR_WEEKS","MONTHLY","CUSTOM"]},"schedules":{"description":"Cron/repeat schedule specs. Required when interval=CUSTOM.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["repeat","cron"],"description":"Schedule type"},"interval":{"description":"Repeat token (e.g., '1h', '1d') when type=repeat","type":"string"},"expressions":{"description":"Cron expressions when type=cron","type":"array","items":{"type":"string"}},"timezone":{"description":"IANA timezone for cron expressions (e.g. 'America/New_York'). Defaults to UTC.","type":"string"}},"required":["type"]}},"weekdaysOnly":{"description":"Skip runs that fall on Saturday or Sunday. Applies only to repeat intervals; for cron, set the weekdays in the expression.","type":"boolean"}},"isRequired":true,"uniqueKey":"data.frequency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.frequency","typeLabel":"object | null"},"createdAt":{"description":"Creation timestamp","type":"string","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string"},"schemaFields":{"oneOf":[{"description":"Resolved schema fields from data_schemas","type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Field name","isRequired":true,"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].name","typeLabel":"string"},"mapper":{"description":"Function that produces this field's value.","type":"string","enum":["jobDescription","categoryClassifier","taxonomyMapping","stableUniqueId","linkExtraction","additionalData","categorize"],"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].mapper","typeLabel":"enum\u003cstring>"},"mapperConfig":{"description":"Configuration for the selected mapper.","type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].mapperConfig.additionalProperties","typeLabel":"any"},"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].mapperConfig","typeLabel":"object"},"description":{"description":"Human-readable field description shown in Kadoa","type":"string","uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].description","typeLabel":"string"},"instruction":{"description":"Separate extraction guidance for legacy authoring. In consolidated workflow mode, put guidance in description instead.","type":"string","uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].instruction","typeLabel":"string"},"fieldType":{"description":"Field role (SCHEMA or CLASSIFICATION)","type":"string","uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].fieldType","typeLabel":"string"},"example":{"description":"Separate sample values for legacy authoring. In consolidated workflow mode, use description for samples and shape for required OBJECT/ARRAY structure.","uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].example","typeLabel":"any"},"shape":{"description":"Authoritative nested shape for OBJECT/ARRAY fields; without it, a JSON object/array example is promoted to the enforced shape at workflow creation.","uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].shape","typeLabel":"any"},"dataType":{"description":"Output data type for SCHEMA fields. Use public values such as STRING, NUMBER, BOOLEAN, DATE, DATETIME, MONEY, IMAGE, LINK, OBJECT, or ARRAY.","type":"string","uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].dataType","typeLabel":"string"},"isKey":{"description":"Marks this field as part of the record's primary key. Key fields define row identity across runs and enable data linking (records with the same key values are treated as the same record over time, used for dedupe and change detection). Set true ONLY when the complete key tuple uniquely identifies a logical output record and every component is stable across runs and reliably present (not nullable/missing). Key fields should be scalar STRING, NUMBER, or LINK fields; avoid structured, semantic, boolean, image, and timestamp/date fields as keys. Good candidates: external IDs, SKUs, canonical URLs, posting IDs. Bad candidates: prices, counts, timestamps, free-text titles/descriptions, or anything that can change between runs. Multiple fields may form a composite key; uniqueness applies to their combination, not each component. For derived rows, source-backed grouping dimensions and a deterministic output discriminator may identify the result; measured values and explanations do not. If no supported key tuple satisfies these guarantees, leave isKey unset on every field — data linking will simply be disabled, which is preferable to a wrong key. Choosing a non-stable or non-unique key causes duplicate rows and missed updates.","type":"boolean","uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].isKey","typeLabel":"boolean"},"categories":{"description":"Predefined categories for CLASSIFICATION fields","type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Short title/label of the category","isRequired":true,"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].categories.items.[INDEX].title","typeLabel":"string"},"definition":{"type":"string","description":"Full definition/description of the category","isRequired":true,"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].categories.items.[INDEX].definition","typeLabel":"string"}},"required":["title","definition"],"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].categories.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].categories","typeLabel":"object[]"}},"required":["name"],"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"data.schemaFields.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.schemaFields.oneOf.0","typeLabel":"object[]"},{"description":"Resolved schema fields from data_schemas","type":"null","items":{"type":"object","properties":{"mapper":{"description":"Function that produces this field's value.","type":"string","enum":["jobDescription","categoryClassifier","taxonomyMapping","stableUniqueId","linkExtraction","additionalData","categorize"]},"mapperConfig":{"description":"Configuration for the selected mapper.","type":"object","additionalProperties":{"oneOf":[{}]}},"name":{"type":"string","description":"Field name"},"description":{"description":"Human-readable field description shown in Kadoa","type":"string"},"instruction":{"description":"Separate extraction guidance for legacy authoring. In consolidated workflow mode, put guidance in description instead.","type":"string"},"fieldType":{"description":"Field role (SCHEMA or CLASSIFICATION)","type":"string"},"example":{"description":"Separate sample values for legacy authoring. In consolidated workflow mode, use description for samples and shape for required OBJECT/ARRAY structure."},"shape":{"description":"Authoritative nested shape for OBJECT/ARRAY fields; without it, a JSON object/array example is promoted to the enforced shape at workflow creation."},"dataType":{"description":"Output data type for SCHEMA fields. Use public values such as STRING, NUMBER, BOOLEAN, DATE, DATETIME, MONEY, IMAGE, LINK, OBJECT, or ARRAY.","type":"string"},"isKey":{"description":"Marks this field as part of the record's primary key. Key fields define row identity across runs and enable data linking (records with the same key values are treated as the same record over time, used for dedupe and change detection). Set true ONLY when the complete key tuple uniquely identifies a logical output record and every component is stable across runs and reliably present (not nullable/missing). Key fields should be scalar STRING, NUMBER, or LINK fields; avoid structured, semantic, boolean, image, and timestamp/date fields as keys. Good candidates: external IDs, SKUs, canonical URLs, posting IDs. Bad candidates: prices, counts, timestamps, free-text titles/descriptions, or anything that can change between runs. Multiple fields may form a composite key; uniqueness applies to their combination, not each component. For derived rows, source-backed grouping dimensions and a deterministic output discriminator may identify the result; measured values and explanations do not. If no supported key tuple satisfies these guarantees, leave isKey unset on every field — data linking will simply be disabled, which is preferable to a wrong key. Choosing a non-stable or non-unique key causes duplicate rows and missed updates.","type":"boolean"},"categories":{"description":"Predefined categories for CLASSIFICATION fields","type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Short title/label of the category"},"definition":{"type":"string","description":"Full definition/description of the category"}},"required":["title","definition"]}}},"required":["name"],"additionalProperties":{"oneOf":[{}]}},"uniqueKey":"data.schemaFields.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.schemaFields","typeLabel":"object[] | null"},"schemaValidationRules":{"oneOf":[{"description":"Schema validation rules for this version","type":"object","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.schemaValidationRules.oneOf.0.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"data.schemaValidationRules.oneOf.0.additionalProperties","typeLabel":"object"},"uniqueKey":"data.schemaValidationRules.oneOf.0","typeLabel":"object"},{"description":"Schema validation rules for this version","type":"null","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.schemaValidationRules.oneOf.1.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"data.schemaValidationRules.oneOf.1.additionalProperties","typeLabel":"object"},"uniqueKey":"data.schemaValidationRules.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.schemaValidationRules","typeLabel":"object | null"},"notifications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Notification configuration ID","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"eventType":{"type":"string","description":"Event type (e.g., workflow_finished, error)","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].eventType","typeLabel":"string"},"eventConfiguration":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.notifications.items.[INDEX].eventConfiguration.additionalProperties","typeLabel":"any"},"description":"Event-specific config","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].eventConfiguration","typeLabel":"object"},"enabled":{"type":"boolean","description":"Whether this notification is enabled","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].enabled","typeLabel":"boolean"},"channels":{"type":"array","items":{"type":"object","properties":{"channelId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].channels.items.[INDEX].channelId","typeLabel":"string\u003cuuid>"},"channelName":{"type":"string","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].channels.items.[INDEX].channelName","typeLabel":"string"},"channelType":{"type":"string","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].channels.items.[INDEX].channelType","typeLabel":"string"}},"required":["channelId","channelName","channelType"],"uniqueKey":"data.notifications.items.[INDEX].channels.items.[INDEX]","typeLabel":"object"},"description":"Linked notification channels","isRequired":true,"uniqueKey":"data.notifications.items.[INDEX].channels","typeLabel":"object[]"}},"required":["id","eventType","eventConfiguration","enabled","channels"],"uniqueKey":"data.notifications.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.notifications","typeLabel":"object[]"},"recordLimit":{"oneOf":[{"description":"Immutable output record limit; null when managed unlimited or unmanaged","type":"integer","minimum":1,"maximum":2147483647,"uniqueKey":"data.recordLimit.oneOf.0","typeLabel":"integer"},{"description":"Immutable output record limit; null when managed unlimited or unmanaged","type":"null","minimum":1,"maximum":2147483647,"uniqueKey":"data.recordLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.recordLimit","typeLabel":"integer | null"},"recordLimitManaged":{"description":"Whether this version owns the workflow output record limit","type":"boolean","uniqueKey":"data.recordLimitManaged","typeLabel":"boolean"}},"required":["id","templateId","version","name","publisher","prompt","schemaId","frequency","createdAt"],"title":"TemplateVersionResponse","description":"Template version","isRequired":true,"uniqueKey":"data","typeLabel":"TemplateVersionResponse · object"}},"required":["error","success","data"],"title":"TemplateVersionMutationResponse","description":"Response for template version create/update","uniqueKey":"","typeLabel":"TemplateVersionMutationResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":false,"success":true,"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","templateId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","version":123,"name":"\u003cstring>","publisher":{"kind":"HUMAN","label":"\u003cstring>"},"prompt":"\u003cstring>","schemaId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","frequency":{"interval":"ONLY_ONCE","schedules":[{"type":"repeat","interval":"\u003cstring>","expressions":["\u003cstring>"],"timezone":"\u003cstring>"}],"weekdaysOnly":true},"createdAt":"\u003cstring>","schemaFields":[{"name":"\u003cstring>","mapper":"jobDescription","mapperConfig":{},"description":"\u003cstring>","instruction":"\u003cstring>","fieldType":"\u003cstring>","example":"\u003cunknown>","shape":"\u003cunknown>","dataType":"\u003cstring>","isKey":true,"categories":[{"title":"\u003cstring>","definition":"\u003cstring>"}]}],"schemaValidationRules":{},"notifications":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","eventType":"\u003cstring>","eventConfiguration":{},"enabled":true,"channels":[{"channelId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","channelName":"\u003cstring>","channelType":"\u003cstring>"}]}],"recordLimit":1073741824,"recordLimitManaged":true}}}},"exampleType":"generated"}},"exampleType":"generated"},"8d7707aa-9bfa-4b7e-ad73-a426dc46de10":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","description":"Indicates an error occurred","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (e.g., validation errors)","uniqueKey":"details","typeLabel":"any"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"\u003cstring>","details":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f445300e-3b6f-440c-8afc-fbba1b4c0459":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","description":"Indicates an error occurred","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (e.g., validation errors)","uniqueKey":"details","typeLabel":"any"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"\u003cstring>","details":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"c6ee7113-8e80-4498-83d7-b2509f5bff51":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","description":"Indicates an error occurred","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (e.g., validation errors)","uniqueKey":"details","typeLabel":"any"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"\u003cstring>","details":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e255e0f4-c458-4b6c-b90d-94d23d456692":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","description":"Indicates an error occurred","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"type":"string","description":"Error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"description":"Additional error details (e.g., validation errors)","uniqueKey":"details","typeLabel":"any"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"\u003cstring>","details":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f3934c2a-143f-41c5-a9c6-d1950c3e0cdb":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"8eaffad7-10ff-4cf4-a47e-9e49a75e3a9b":{"url":"https://api.kadoa.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for authentication","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"API key for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://api.kadoa.com/openapi"},"subdomain":"kadoa","siteName":"Kadoa Documentation","title":"Create template version - Kadoa Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-03T17:38:34.360Z","originalFileLocation":"api-reference/templates/create-version.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=\"light\"}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=\"Publish a new version of a template with prompt, schema, validation, and notification settings\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kadoa Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kadoa/WdUKDmwYX3I6vjmm/_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/kadoa/WdUKDmwYX3I6vjmm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kadoa/WdUKDmwYX3I6vjmm/_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/kadoa/WdUKDmwYX3I6vjmm/_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/kadoa/WdUKDmwYX3I6vjmm/_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/kadoa/WdUKDmwYX3I6vjmm/_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/kadoa/WdUKDmwYX3I6vjmm/_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/kadoa/WdUKDmwYX3I6vjmm/_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/kadoa/WdUKDmwYX3I6vjmm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create template version - Kadoa Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Publish a new version of a template with prompt, schema, validation, and notification settings\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kadoa Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kadoa.com/api-reference/templates/create-version\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kadoa.mintlify.site/_mintlify/api/og/v2?division=Templates\u0026amp;title=Create+template+version\u0026amp;description=Publish+a+new+version+of+a+template+with+prompt%2C+schema%2C+validation%2C+and+notification+settings\u0026amp;theme=f7734677e3eaa036806ff0f8\u0026amp;signature=e1f6092345040453e0b2c583caa4f4d8f8f6e49c9e4b3850456bdaac2d5af6d4\">\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 template version - Kadoa Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Publish a new version of a template with prompt, schema, validation, and notification settings\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kadoa.mintlify.site/_mintlify/api/og/v2?division=Templates\u0026amp;title=Create+template+version\u0026amp;description=Publish+a+new+version+of+a+template+with+prompt%2C+schema%2C+validation%2C+and+notification+settings\u0026amp;theme=f7734677e3eaa036806ff0f8\u0026amp;signature=e1f6092345040453e0b2c583caa4f4d8f8f6e49c9e4b3850456bdaac2d5af6d4\">\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/kadoa/WdUKDmwYX3I6vjmm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kadoa Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ea580c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kadoa.com/api-reference/templates/create-version\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/templates/create-version.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kadoa.com/#organization\",\"name\":\"Kadoa Documentation\",\"url\":\"https://docs.kadoa.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kadoa/dCOYM0EuffD9qYID/logo/kadoa-logo.svg?fit=max\u0026auto=format\u0026n=dCOYM0EuffD9qYID\u0026q=85\u0026s=344d5ae11cb3c2519a3c1541507ebed5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kadoa.com#website\",\"name\":\"Kadoa Documentation\",\"url\":\"https://docs.kadoa.com\",\"publisher\":{\"@id\":\"https://docs.kadoa.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kadoa.com/api-reference/templates/create-version#webpage\",\"url\":\"https://docs.kadoa.com/api-reference/templates/create-version\",\"name\":\"Create template version\",\"description\":\"Publish a new version of a template with prompt, schema, validation, and notification settings\",\"dateModified\":\"2026-04-03T17:38:34.360Z\",\"isPartOf\":{\"@id\":\"https://docs.kadoa.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kadoa.com/api-reference/templates/create-version#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kadoa.com/api-reference/templates/create-version#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.kadoa.com/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Templates\",\"item\":\"https://docs.kadoa.com/api-reference/templates/list-templates\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create template version\",\"item\":\"https://docs.kadoa.com/api-reference/templates/create-version\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.kadoa.com/api-reference/templates/create-version#apireference\",\"headline\":\"Create template version\",\"name\":\"Create template version\",\"description\":\"Publish a new version of a template with prompt, schema, validation, and notification settings\",\"url\":\"https://docs.kadoa.com/api-reference/templates/create-version\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kadoa.com/api-reference/templates/create-version#webpage\"},\"dateModified\":\"2026-04-03T17:38:34.360Z\",\"publisher\":{\"@id\":\"https://docs.kadoa.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kadoa.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kadoa Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Kadoa Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/templates/create-version.md","siteName":"Kadoa Documentation","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":{"style":"duotone","name":"clock-rotate-left"},"href":"https://www.kadoa.com/changelog"},{"anchor":"Trust Center","icon":{"style":"duotone","name":"shield-check"},"href":"https://trust.kadoa.com"},{"anchor":"Contact Us","icon":{"style":"duotone","name":"envelope"},"href":"https://www.kadoa.com/contact"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"group":"Workflows","pages":[{"openapi":"get /v4/workflows/{workflowId}/data","title":"Get workflow data by ID","href":"/api-reference/workflows/get-workflow-data-by-id"},{"openapi":"get /v4/workflows/{workflowId}/data/export","title":"Create workflow data export","href":"/api-reference/workflows/create-workflow-data-export"},{"openapi":"get /v4/workflows/{workflowId}/data/exports/{exportId}","title":"Download workflow data export","href":"/api-reference/workflows/download-workflow-data-export"},{"openapi":"get /v4/workflows","title":"Get a list of workflows","href":"/api-reference/workflows/get-all-workflows"},{"openapi":"get /v4/workflows/{workflowId}","title":"Get workflow by ID","href":"/api-reference/workflows/get-workflow-by-id"},{"openapi":"get /v4/workflows/{workflowId}/connectors","title":"List destinations delivering this workflow's results","href":"/api-reference/workflows/list-workflow-connectors"},{"openapi":"post /v4/workflows","title":"Create a new workflow","href":"/api-reference/workflows/create-a-new-workflow"},{"openapi":"put /v4/workflows/{workflowId}/run","title":"Run a workflow","href":"/api-reference/workflows/run-a-workflow"},{"openapi":"put /v4/workflows/{workflowId}/schedule","title":"Schedule a workflow","href":"/api-reference/workflows/schedule-a-workflow"},{"openapi":"put /v4/workflows/{workflowId}/metadata","title":"Update workflow metadata","href":"/api-reference/workflows/update-workflow-metadata"},{"openapi":"put /v4/workflows/{workflowId}/pause","title":"Pause a workflow","href":"/api-reference/workflows/pause-a-workflow"},{"openapi":"delete /v4/workflows/{workflowId}","title":"Delete a workflow","href":"/api-reference/workflows/delete-a-workflow"},{"openapi":"put /v4/workflows/{workflowId}/resume","title":"Resume or unpause a workflow","href":"/api-reference/workflows/resume-a-workflow"},{"openapi":"get /v4/workflows/{workflowId}/history","title":"Get the workflow run history","href":"/api-reference/workflows/get-the-workflow-history"},{"openapi":"get /v4/workflows/{workflowId}/quality-metrics","title":"Get workflow quality metrics","href":"/api-reference/workflows/get-workflow-quality-metrics"},{"group":"Workflow Triggers","pages":[{"openapi":"get /v4/workflows/{workflowId}/triggers","title":"List workflow triggers","href":"/api-reference/workflows/list-workflow-triggers"},{"openapi":"post /v4/workflows/{workflowId}/triggers","title":"Create a workflow trigger","href":"/api-reference/workflows/create-workflow-trigger"},{"openapi":"get /v4/workflows/{workflowId}/triggers/{triggerId}","title":"Get a specific trigger","href":"/api-reference/workflows/get-workflow-trigger"},{"openapi":"patch /v4/workflows/{workflowId}/triggers/{triggerId}","title":"Update a trigger","href":"/api-reference/workflows/update-workflow-trigger"},{"openapi":"delete /v4/workflows/{workflowId}/triggers/{triggerId}","title":"Delete a trigger","href":"/api-reference/workflows/delete-workflow-trigger"}]}]},{"group":"Agent","pages":[{"title":"Create or continue an Agent session","openapi":"post /v5/agent","href":"/api-reference/assistant/create-or-continue-session"},{"title":"Send a Workflow Agent message","openapi":"post /v5/agent/workflows/{workflowId}/assistant/messages","href":"/api-reference/assistant/send-workflow-message"},{"title":"Get Workflow Agent timeline","openapi":"get /v5/agent/workflows/{workflowId}/timeline","href":"/api-reference/assistant/get-workflow-timeline"},{"title":"Get Agent pause state","openapi":"get /v5/agent/{sessionId}/pause-state","href":"/api-reference/assistant/get-pause-state"},{"title":"Answer an Agent question","openapi":"post /v5/agent/answer","href":"/api-reference/assistant/answer-question"},{"title":"Interrupt an Agent session","openapi":"post /v5/agent/{sessionId}/interrupt","href":"/api-reference/assistant/interrupt-session"},{"title":"Resume an Agent session","openapi":"post /v5/agent/{sessionId}/resume","href":"/api-reference/assistant/resume-session"},{"title":"Stop an Agent session","openapi":"post /v5/agent/{sessionId}/stop","href":"/api-reference/assistant/stop-session"},{"title":"Get Agent strategy","openapi":"get /v5/agent/data/{sessionId}/strategy","href":"/api-reference/assistant/get-strategy"}]},{"group":"Variables","pages":[{"openapi":"post /v4/variables/","title":"Create a variable","href":"/api-reference/variables/create-a-variable"},{"openapi":"get /v4/variables/","title":"List all variables","href":"/api-reference/variables/list-all-variables"},{"openapi":"get /v4/variables/{variableId}","title":"Get a variable","href":"/api-reference/variables/get-a-variable"},{"openapi":"patch /v4/variables/{variableId}","title":"Update a variable","href":"/api-reference/variables/update-a-variable"},{"openapi":"delete /v4/variables/{variableId}","title":"Delete a variable","href":"/api-reference/variables/delete-a-variable"}]},{"group":"Data Changes","pages":[{"openapi":"get /v4/changes","title":"Get all data changes","href":"/api-reference/monitoring/get-all-changes"},{"openapi":"get /v4/changes/{changeId}","title":"Get data change by ID","href":"/api-reference/monitoring/get-change-by-id"}]},{"group":"Notifications","pages":[{"openapi":"post /v5/notifications/channels","title":"Create a new notification channel","href":"/api-reference/notifications/create-notification-channel"},{"openapi":"post /v5/notifications/settings","title":"Create a new notification settings","href":"/api-reference/notifications/create-notification-settings"},{"openapi":"delete /v5/notifications/channels/{channelId}","title":"Delete a notification channel","href":"/api-reference/notifications/delete-notification-channel"},{"openapi":"delete /v5/notifications/settings/{settingsId}","title":"Delete a notification settings","href":"/api-reference/notifications/delete-notification-settings"},{"openapi":"get /v5/notifications/event-types/{eventType}","title":"Retrieve a specific event type details","href":"/api-reference/notifications/get-event-type"},{"openapi":"get /v5/notifications/event-types","title":"Retrieve all available notification event types","href":"/api-reference/notifications/get-event-types"},{"openapi":"get /v5/notifications/channels/{channelId}","title":"Retrieve a specific notification channel","href":"/api-reference/notifications/get-notification-channel"},{"openapi":"get /v5/notifications/channels","title":"Retrieve all notification channels","href":"/api-reference/notifications/get-notification-channels"},{"openapi":"get /v5/notifications/settings/{settingsId}","title":"Retrieve a specific notification settings","href":"/api-reference/notifications/get-notification-setting"},{"openapi":"get /v5/notifications/settings","title":"Retrieve all notification settings","href":"/api-reference/notifications/get-notification-settings"},{"openapi":"post /v5/notifications/test","title":"Test a notification settings with mock data","href":"/api-reference/notifications/test-notifications"},{"openapi":"put /v5/notifications/channels/{channelId}","title":"Update a notification channel","href":"/api-reference/notifications/update-notification-channel"},{"openapi":"put /v5/notifications/settings/{settingsId}","title":"Update a notification settings","href":"/api-reference/notifications/update-notification-settings"}]},{"group":"Schemas","pages":[{"openapi":"get /v4/schemas/","title":"List all schemas","href":"/api-reference/schemas/get-all-schemas"},{"openapi":"get /v4/schemas/{schemaId}","title":"Get schema by ID","href":"/api-reference/schemas/get-schema-by-id"},{"openapi":"post /v4/schemas/","title":"Create new schema","href":"/api-reference/schemas/create-schema"},{"openapi":"put /v4/schemas/{schemaId}","title":"Update existing schema","href":"/api-reference/schemas/update-schema"},{"openapi":"delete /v4/schemas/{schemaId}","title":"Delete schema","href":"/api-reference/schemas/delete-schema"}]},{"group":"Locations","pages":[{"openapi":"get /v4/locations","title":"Get all available locations","href":"/api-reference/locations/get-all-locations"}]},{"group":"Data Quality","pages":[{"title":"Get data quality rules","openapi":"get /v4/workflows/{workflowId}/schema-validation-rules","href":"/api-reference/data-quality/get-rules"},{"title":"Upsert data quality rules","openapi":"put /v4/workflows/{workflowId}/schema-validation-rules","href":"/api-reference/data-quality/upsert-rules"},{"title":"Delete data quality rules for a field","openapi":"delete /v4/workflows/{workflowId}/schema-validation-rules/{fieldName}","href":"/api-reference/data-quality/delete-field-rules"}]},{"group":"Templates","pages":[{"title":"List templates","openapi":"get /v4/templates/","href":"/api-reference/templates/list-templates"},{"title":"Get template","openapi":"get /v4/templates/{templateId}","href":"/api-reference/templates/get-template"},{"title":"Create template","openapi":"post /v4/templates/","href":"/api-reference/templates/create-template"},{"title":"Update template","openapi":"put /v4/templates/{templateId}","href":"/api-reference/templates/update-template"},{"title":"Delete template","description":"Archive a template (soft delete)","openapi":"delete /v4/templates/{templateId}","href":"/api-reference/templates/delete-template"},{"title":"Create template version","openapi":"post /v4/templates/{templateId}/versions","href":"/api-reference/templates/create-version"},{"title":"List template schemas","description":"Retrieve all schemas linked to a template","openapi":"get /v4/templates/{templateId}/schemas","href":"/api-reference/templates/list-schemas"},{"title":"List template workflows","openapi":"get /v4/templates/{templateId}/workflows","href":"/api-reference/templates/list-workflows"},{"title":"Apply template update","openapi":"post /v4/templates/{templateId}/apply","href":"/api-reference/templates/apply-update"},{"title":"Preview schema change","openapi":"post /v4/templates/{templateId}/preview-schema-change","href":"/api-reference/templates/preview-schema-change"},{"title":"Link workflows to template","openapi":"post /v4/templates/{templateId}/link","href":"/api-reference/templates/link-workflows"},{"title":"Unlink workflows from template","openapi":"post /v4/templates/{templateId}/unlink","href":"/api-reference/templates/unlink-workflows"},{"title":"Save workflow as template","openapi":"post /v4/templates/from-workflow","href":"/api-reference/templates/save-from-workflow"}]},{"group":"Support","pages":[{"title":"List support issues","openapi":"get /v4/support/issues","href":"/api-reference/support/get-support-issues"},{"title":"Create support issue","openapi":"post /v4/support/issues","href":"/api-reference/support/create-support-issue"},{"title":"Update support issue","openapi":"patch /v4/support/issues/{issueId}","href":"/api-reference/support/update-support-issue"},{"title":"Get issue states","openapi":"get /v4/support/states","href":"/api-reference/support/get-support-states"}]}]}]}]},"basePath":"","title":"Create template version - Kadoa Documentation","buildId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","deploymentId":"dpl_8hoxaqFTU7hTr6A2fUraxAyjuiZo","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CDiBsYGW.js","utils-KF9rPlmF.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C26urKTX.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BdjmJAC1.js","snippetPresets-3IpDBjt3.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-1CZdsdAn.js","ApiExamples-D4x_2vvo.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BIWdc5Pa.js","shallow-LQqfiMNd.js","getApiPlaygroundDisplay-DryzlOZG.js","CodeSnippet-tcJujU4r.js","CodeSnippets-BHp0nVLL.js","getPastedJson-DU-1ayUv.js","icon-CZK2hPr4.js","MethodPill-DOaqmTFC.js","DuplicateIcon-B5-nUxxl.js","createIcon-CDP_U77G.js","DynamicMarkdown-GHvayGOn.js","SectionHeading-BYvpkmUD.js","axios-vUo_bRtp.js","Markdown-uxhlayGT.js","clsx-B35qUV0p.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BvrGG8gU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CAf0yVYe.js"]}