Creates a template owned by the authenticated user. Private and
user-scoped by default; provide workspace_id to create a
workspace-scoped template (caller must be a workspace admin).
Pass template_type: chain with a chain_config to install a chain
method-spec (HAR-1098). Chain creation is subject to the same per-plan
step cap as launching a chain (Free is capped; paid is unlimited).
API key authentication. Pass your key as a Bearer token.
Keys use the format hm_live_<32 hex chars>.
Generate keys from your Harmonica dashboard settings.
Multi-step chain definition (used when template_type is 'chain'). Validated server-side (HAR-915): at least one step, unique step ids, valid role / assignment / completion shapes.
Provenance for a template installed from the OFL method-specs registry; null for admin-authored templates (HAR-1108).
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Harmonica","colors":{"primary":"#1C1917","light":"#FFFFFF","dark":"#0C0A09"},"logo":{"light":"https://mintcdn.com/harmonica/aEc6kd8uk1Uw-f5Z/logo/light.svg?fit=max\u0026auto=format\u0026n=aEc6kd8uk1Uw-f5Z\u0026q=85\u0026s=53ddfa4a237729aac2f91dd80bacbdb6","dark":"https://mintcdn.com/harmonica/aEc6kd8uk1Uw-f5Z/logo/dark.svg?fit=max\u0026auto=format\u0026n=aEc6kd8uk1Uw-f5Z\u0026q=85\u0026s=b167b5116f98124a9d55673aacd5636f"},"favicon":"https://mintcdn.com/harmonica/aEc6kd8uk1Uw-f5Z/favicon.svg?fit=max\u0026auto=format\u0026n=aEc6kd8uk1Uw-f5Z\u0026q=85\u0026s=9d19d51b5fe8bd3adf22deaf42d1c9cb","navbar":{"links":[{"href":"mailto:hello@harmonica.chat","label":"Support"}],"primary":{"type":"button","label":"Open Harmonica","href":"https://app.harmonica.chat"}},"footer":{"socials":{}},"fonts":{"family":"Instrument Sans"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"harmonica","hasAudioNarration":false,"actualSubdomain":"harmonica","customDomains":["help.harmonica.chat"],"gitSource":{"type":"github","owner":"harmonicabot","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae6415ccf4408c76828b8bf","collectionId":"39c0eb97-4423-449d-8542-ea555992d6a0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae6415ccf4408c76828b8bf"},"entitlements":{},"buildId":"6ae6415ccf4408c76828b8bf","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":42},{"language":"default","tag":"Endpoints","count":37},{"language":"default","tag":"Guides","count":19},{"language":"default","tag":"For hosts","count":14},{"language":"default","tag":"Getting started","count":4},{"language":"default","tag":"Integrations","count":3},{"language":"default","tag":"Overview","count":2},{"language":"default","tag":"For participants","count":1}]},"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","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}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"#navbar img,a[href=\"/\"] img,header img[src*=logo],nav img{height:1rem!important;max-height:1rem!important;width:auto!important}"}],"page":{"pagePath":"api-reference/templates/create-template","slug":"/api-reference/templates/create-template","pageMetadata":{"title":"Create template","description":"Creates a template owned by the authenticated user. Private and\nuser-scoped by default; provide `workspace_id` to create a\nworkspace-scoped template (caller must be a workspace admin).\n\nPass `template_type: chain` with a `chain_config` to install a chain\nmethod-spec (HAR-1098). Chain creation is subject to the same per-plan\nstep cap as launching a chain (Free is capped; paid is unlimited).\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /templates","href":"/api-reference/templates/create-template","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Creates a template owned by the authenticated user. Private and\\nuser-scoped by default; provide \", _jsx(_components.code, {\n children: \"workspace_id\"\n }), \" to create a\\nworkspace-scoped template (caller must be a workspace admin).\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Pass \", _jsx(_components.code, {\n children: \"template_type: chain\"\n }), \" with a \", _jsx(_components.code, {\n children: \"chain_config\"\n }), \" to install a chain\\nmethod-spec (HAR-1098). Chain creation is subject to the same per-plan\\nstep cap as launching a chain (Free is capped; paid is unlimited).\"]\n })]\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","description":"Creates a template owned by the authenticated user. Private and\nuser-scoped by default; provide `workspace_id` to create a\nworkspace-scoped template (caller must be a workspace admin).\n\nPass `template_type: chain` with a `chain_config` to install a chain\nmethod-spec (HAR-1098). Chain creation is subject to the same per-plan\nstep cap as launching a chain (Free is capped; paid is unlimited).\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /templates","href":"/api-reference/templates/create-template","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create template","description":"Creates a template owned by the authenticated user. Private and\nuser-scoped by default; provide `workspace_id` to create a\nworkspace-scoped template (caller must be a workspace admin).\n\nPass `template_type: chain` with a `chain_config` to install a chain\nmethod-spec (HAR-1098). Chain creation is subject to the same per-plan\nstep cap as launching a chain (Free is capped; paid is unlimited).\n","operationId":"createTemplate","tags":["Templates"],"requestBody":"38e3e3bc-6c7f-4beb-9c32-8022f8d8e521","responses":{"201":"44894ddc-17af-4fd4-bb56-830c6a9ff2ff","400":"027ed168-aac6-4674-955e-418600d02dcf","401":"22a6fd8d-3a0d-4efd-916e-a63f5de36c8a","403":"8b9d64ea-4c8b-4a5a-8b2e-c0312266dbc2"},"method":"post","type":"path","servers":["159ba40a-931d-4ff5-8f2f-ba0c710bfa77","3accf909-7c53-4e10-b168-fa6c780b47a7"],"security":["df3448de-fee5-4da1-ae28-dbf782e2212d"],"path":"/templates","baseUrlOptions":["https://app.harmonica.chat/api/v1","http://localhost:3000/api/v1"],"title":"Create template","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"icon":{"oneOf":[{"type":"string","uniqueKey":"icon.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"icon.oneOf.1","typeLabel":"null"}],"uniqueKey":"icon","typeLabel":"string | null"},"facilitation_prompt":{"oneOf":[{"type":"string","uniqueKey":"facilitation_prompt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"facilitation_prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"facilitation_prompt","typeLabel":"string | null"},"default_session_name":{"oneOf":[{"type":"string","uniqueKey":"default_session_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_session_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_session_name","typeLabel":"string | null"},"default_goal":{"oneOf":[{"type":"string","uniqueKey":"default_goal.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_goal.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_goal","typeLabel":"string | null"},"default_critical":{"oneOf":[{"type":"string","uniqueKey":"default_critical.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_critical.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_critical","typeLabel":"string | null"},"default_context":{"oneOf":[{"type":"string","uniqueKey":"default_context.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_context.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_context","typeLabel":"string | null"},"is_public":{"type":"boolean","default":false,"uniqueKey":"is_public","typeLabel":"boolean"},"workspace_id":{"oneOf":[{"type":"string","description":"When set, creates a workspace-scoped template (caller must be a workspace admin).","uniqueKey":"workspace_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"When set, creates a workspace-scoped template (caller must be a workspace admin).","uniqueKey":"workspace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"workspace_id","typeLabel":"string | null"},"template_type":{"type":"string","enum":["single","chain"],"description":"Pass 'chain' (with chain_config) to install a chain method-spec (HAR-1098). Defaults to 'single'.","uniqueKey":"template_type","typeLabel":"enum\u003cstring>"},"chain_config":{"type":"object","description":"Multi-step chain definition (used when template_type is 'chain'). Validated server-side (HAR-915): at least one step, unique step ids, valid role / assignment / completion shapes.","required":["steps"],"properties":{"steps":{"type":"array","minItems":1,"items":{"type":"object","required":["id"],"properties":{"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].id","typeLabel":"string"},"title":{"type":"string","uniqueKey":"chain_config.steps.items.[INDEX].title","typeLabel":"string"},"description":{"type":"string","uniqueKey":"chain_config.steps.items.[INDEX].description","typeLabel":"string"},"facilitation_prompt":{"type":"string","uniqueKey":"chain_config.steps.items.[INDEX].facilitation_prompt","typeLabel":"string"},"default_session_name":{"type":"string","uniqueKey":"chain_config.steps.items.[INDEX].default_session_name","typeLabel":"string"},"context_mode":{"type":"string","enum":["none","previous_summary","all_summaries","custom"],"uniqueKey":"chain_config.steps.items.[INDEX].context_mode","typeLabel":"enum\u003cstring>"},"context_template":{"type":"string","uniqueKey":"chain_config.steps.items.[INDEX].context_template","typeLabel":"string"},"individual_memory":{"type":"boolean","uniqueKey":"chain_config.steps.items.[INDEX].individual_memory","typeLabel":"boolean"},"roles":{"type":"array","items":{"type":"object","required":["slug","label"],"properties":{"slug":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].roles.items.[INDEX].slug","typeLabel":"string"},"label":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].roles.items.[INDEX].label","typeLabel":"string"},"weight":{"type":"string","enum":["normal","elevated","lead"],"uniqueKey":"chain_config.steps.items.[INDEX].roles.items.[INDEX].weight","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.steps.items.[INDEX].roles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"chain_config.steps.items.[INDEX].roles","typeLabel":"object[]"},"assignment_strategy":{"type":"string","enum":["explicit","round_robin","first_come_first_served","host_assigned","all_participants"],"uniqueKey":"chain_config.steps.items.[INDEX].assignment_strategy","typeLabel":"enum\u003cstring>"},"completion_criteria":{"oneOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["host_continue"],"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.0","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["all_submitted"],"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.1","typeLabel":"object"},{"type":"object","required":["type","duration_seconds"],"properties":{"type":{"type":"string","enum":["timer"],"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.2.type","typeLabel":"enum\u003cstring>"},"duration_seconds":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.2.duration_seconds","typeLabel":"number"}},"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.2","typeLabel":"object"},{"type":"object","required":["type","count"],"properties":{"type":{"type":"string","enum":["quorum"],"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.3.type","typeLabel":"enum\u003cstring>"},"count":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.3.count","typeLabel":"integer"}},"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.3","typeLabel":"object"},{"type":"object","required":["type","percent"],"properties":{"type":{"type":"string","enum":["quorum_percent"],"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.4.type","typeLabel":"enum\u003cstring>"},"percent":{"type":"number","exclusiveMinimum":0,"maximum":100,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.4.percent","typeLabel":"number"},"require_host_until_all_submitted":{"type":"boolean","default":false,"description":"Require host approval at the configured quorum and advance automatically only when all assignments complete. Hybrid handoff feedback uses completed canonical responses.","uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.4.require_host_until_all_submitted","typeLabel":"boolean"}},"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria.oneOf.4","typeLabel":"object"}],"uniqueKey":"chain_config.steps.items.[INDEX].completion_criteria","typeLabel":"object"},"dimension_ownership":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"chain_config.steps.items.[INDEX].dimension_ownership.items.[INDEX]","typeLabel":"string"},"uniqueKey":"chain_config.steps.items.[INDEX].dimension_ownership","typeLabel":"string[]"},"pre_survey_config":{"type":"array","items":{"type":"object","required":["key","label","type","required"],"properties":{"key":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","enum":["Short field","Email","Options"],"isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX].required","typeLabel":"boolean"},"options":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX].options.items.[INDEX]","typeLabel":"string"},"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX].options","typeLabel":"string[]"},"derive_options_from":{"type":"string","enum":["previous_step"],"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX].derive_options_from","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config.items.[INDEX]","typeLabel":"object"},"uniqueKey":"chain_config.steps.items.[INDEX].pre_survey_config","typeLabel":"object[]"}},"uniqueKey":"chain_config.steps.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"chain_config.steps","typeLabel":"object[]"},"output_artifact":{"type":"string","enum":["wardley","sixhats","cynefin"],"uniqueKey":"chain_config.output_artifact","typeLabel":"enum\u003cstring>"},"project_summary_prompt":{"type":"string","uniqueKey":"chain_config.project_summary_prompt","typeLabel":"string"}},"uniqueKey":"chain_config","typeLabel":"object"},"source_provenance":{"type":"object","description":"Spec identity for a registry install; the server stamps install_hash + timestamps (HAR-1108).","properties":{"spec_id":{"type":"string","isRequired":true,"uniqueKey":"source_provenance.spec_id","typeLabel":"string"},"spec_version":{"type":"string","isRequired":true,"uniqueKey":"source_provenance.spec_version","typeLabel":"string"},"registry":{"type":"string","isRequired":true,"uniqueKey":"source_provenance.registry","typeLabel":"string"}},"required":["spec_id","spec_version","registry"],"uniqueKey":"source_provenance","typeLabel":"object"}},"required":["title"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","description":"\u003cstring>","icon":"\u003cstring>","facilitation_prompt":"\u003cstring>","default_session_name":"\u003cstring>","default_goal":"\u003cstring>","default_critical":"\u003cstring>","default_context":"\u003cstring>","is_public":false,"workspace_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"44894ddc-17af-4fd4-bb56-830c6a9ff2ff":{"description":"Template created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"template_type":{"type":"string","description":"single or chain","isRequired":true,"uniqueKey":"template_type","typeLabel":"string"},"cross_pollination_default":{"type":"boolean","isRequired":true,"uniqueKey":"cross_pollination_default","typeLabel":"boolean"},"is_public":{"type":"boolean","isRequired":true,"uniqueKey":"is_public","typeLabel":"boolean"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"icon":{"oneOf":[{"type":"string","uniqueKey":"icon.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"icon.oneOf.1","typeLabel":"null"}],"uniqueKey":"icon","typeLabel":"string | null"},"facilitation_prompt":{"oneOf":[{"type":"string","uniqueKey":"facilitation_prompt.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"facilitation_prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"facilitation_prompt","typeLabel":"string | null"},"default_session_name":{"oneOf":[{"type":"string","uniqueKey":"default_session_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_session_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_session_name","typeLabel":"string | null"},"default_goal":{"oneOf":[{"type":"string","uniqueKey":"default_goal.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_goal.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_goal","typeLabel":"string | null"},"default_critical":{"oneOf":[{"type":"string","uniqueKey":"default_critical.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_critical.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_critical","typeLabel":"string | null"},"default_context":{"oneOf":[{"type":"string","uniqueKey":"default_context.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"default_context.oneOf.1","typeLabel":"null"}],"uniqueKey":"default_context","typeLabel":"string | null"},"chain_config":{"oneOf":[{"type":"object","description":"Chain definition for chain templates; null for single templates (HAR-1098).","required":["steps"],"properties":{"steps":{"type":"array","minItems":1,"items":{"type":"object","required":["id"],"properties":{"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].id","typeLabel":"string"},"title":{"type":"string","uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].title","typeLabel":"string"},"description":{"type":"string","uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].description","typeLabel":"string"},"facilitation_prompt":{"type":"string","uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].facilitation_prompt","typeLabel":"string"},"default_session_name":{"type":"string","uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].default_session_name","typeLabel":"string"},"context_mode":{"type":"string","enum":["none","previous_summary","all_summaries","custom"],"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].context_mode","typeLabel":"enum\u003cstring>"},"context_template":{"type":"string","uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].context_template","typeLabel":"string"},"individual_memory":{"type":"boolean","uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].individual_memory","typeLabel":"boolean"},"roles":{"type":"array","items":{"type":"object","required":["slug","label"],"properties":{"slug":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].roles.items.[INDEX].slug","typeLabel":"string"},"label":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].roles.items.[INDEX].label","typeLabel":"string"},"weight":{"type":"string","enum":["normal","elevated","lead"],"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].roles.items.[INDEX].weight","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].roles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].roles","typeLabel":"object[]"},"assignment_strategy":{"type":"string","enum":["explicit","round_robin","first_come_first_served","host_assigned","all_participants"],"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].assignment_strategy","typeLabel":"enum\u003cstring>"},"completion_criteria":{"oneOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["host_continue"],"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.0","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["all_submitted"],"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.1","typeLabel":"object"},{"type":"object","required":["type","duration_seconds"],"properties":{"type":{"type":"string","enum":["timer"],"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.2.type","typeLabel":"enum\u003cstring>"},"duration_seconds":{"type":"number","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.2.duration_seconds","typeLabel":"number"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.2","typeLabel":"object"},{"type":"object","required":["type","count"],"properties":{"type":{"type":"string","enum":["quorum"],"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.3.type","typeLabel":"enum\u003cstring>"},"count":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.3.count","typeLabel":"integer"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.3","typeLabel":"object"},{"type":"object","required":["type","percent"],"properties":{"type":{"type":"string","enum":["quorum_percent"],"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.4.type","typeLabel":"enum\u003cstring>"},"percent":{"type":"number","exclusiveMinimum":0,"maximum":100,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.4.percent","typeLabel":"number"},"require_host_until_all_submitted":{"type":"boolean","default":false,"description":"Require host approval at the configured quorum and advance automatically only when all assignments complete. Hybrid handoff feedback uses completed canonical responses.","uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.4.require_host_until_all_submitted","typeLabel":"boolean"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria.oneOf.4","typeLabel":"object"}],"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].completion_criteria","typeLabel":"object"},"dimension_ownership":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].dimension_ownership.items.[INDEX]","typeLabel":"string"},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].dimension_ownership","typeLabel":"string[]"},"pre_survey_config":{"type":"array","items":{"type":"object","required":["key","label","type","required"],"properties":{"key":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","enum":["Short field","Email","Options"],"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"required":{"type":"boolean","isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX].required","typeLabel":"boolean"},"options":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX].options.items.[INDEX]","typeLabel":"string"},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX].options","typeLabel":"string[]"},"derive_options_from":{"type":"string","enum":["previous_step"],"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX].derive_options_from","typeLabel":"enum\u003cstring>"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config.items.[INDEX]","typeLabel":"object"},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX].pre_survey_config","typeLabel":"object[]"}},"uniqueKey":"chain_config.oneOf.0.steps.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"chain_config.oneOf.0.steps","typeLabel":"object[]"},"output_artifact":{"type":"string","enum":["wardley","sixhats","cynefin"],"uniqueKey":"chain_config.oneOf.0.output_artifact","typeLabel":"enum\u003cstring>"},"project_summary_prompt":{"type":"string","uniqueKey":"chain_config.oneOf.0.project_summary_prompt","typeLabel":"string"}},"uniqueKey":"chain_config.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"chain_config.oneOf.1","typeLabel":"null"}],"uniqueKey":"chain_config","typeLabel":"object | null"},"workspace_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"workspace_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"workspace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"workspace_id","typeLabel":"string\u003cuuid> | null"},"created_by":{"oneOf":[{"type":"string","uniqueKey":"created_by.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"created_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_by","typeLabel":"string | null"},"archived_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"archived_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"archived_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"archived_at","typeLabel":"string\u003cdate-time> | null"},"source_provenance":{"oneOf":[{"type":"object","description":"Provenance for a template installed from the OFL method-specs registry; null for admin-authored templates (HAR-1108).","properties":{"spec_id":{"type":"string","uniqueKey":"source_provenance.oneOf.0.spec_id","typeLabel":"string"},"spec_version":{"type":"string","uniqueKey":"source_provenance.oneOf.0.spec_version","typeLabel":"string"},"registry":{"type":"string","uniqueKey":"source_provenance.oneOf.0.registry","typeLabel":"string"},"install_hash":{"type":"string","description":"sha256 of the canonicalized chain_config as installed","uniqueKey":"source_provenance.oneOf.0.install_hash","typeLabel":"string"},"installed_at":{"type":"string","format":"date-time","uniqueKey":"source_provenance.oneOf.0.installed_at","typeLabel":"string\u003cdate-time>"},"installed_by":{"oneOf":[{"type":"string","uniqueKey":"source_provenance.oneOf.0.installed_by.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source_provenance.oneOf.0.installed_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_provenance.oneOf.0.installed_by","typeLabel":"string | null"}},"uniqueKey":"source_provenance.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"source_provenance.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_provenance","typeLabel":"object | null"}},"required":["id","title","template_type","cross_pollination_default","is_public","created_at","updated_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","title":"\u003cstring>","template_type":"\u003cstring>","cross_pollination_default":true,"is_public":true,"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","description":"\u003cstring>","icon":"\u003cstring>","facilitation_prompt":"\u003cstring>","default_session_name":"\u003cstring>","default_goal":"\u003cstring>","default_critical":"\u003cstring>","default_context":"\u003cstring>","chain_config":{"steps":[{"id":"\u003cstring>","title":"\u003cstring>","description":"\u003cstring>","facilitation_prompt":"\u003cstring>","default_session_name":"\u003cstring>","context_mode":"none","context_template":"\u003cstring>","individual_memory":true,"roles":[{"slug":"\u003cstring>","label":"\u003cstring>","weight":"normal"}],"assignment_strategy":"explicit","completion_criteria":{"type":"host_continue"},"dimension_ownership":["\u003cstring>"],"pre_survey_config":[{"key":"\u003cstring>","label":"\u003cstring>","type":"Short field","required":true,"options":["\u003cstring>"],"derive_options_from":"previous_step"}]}],"output_artifact":"wardley","project_summary_prompt":"\u003cstring>"},"workspace_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_by":"\u003cstring>","archived_at":"2023-11-07T05:31:56Z","source_provenance":{"spec_id":"\u003cstring>","spec_version":"\u003cstring>","registry":"\u003cstring>","install_hash":"\u003cstring>","installed_at":"2023-11-07T05:31:56Z","installed_by":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"027ed168-aac6-4674-955e-418600d02dcf":{"description":"Validation error (missing required fields)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","not_found","validation_error","rate_limited","payment_required","transcript_revision_changed","internal_error","unprocessable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"22a6fd8d-3a0d-4efd-916e-a63f5de36c8a":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","not_found","validation_error","rate_limited","payment_required","transcript_revision_changed","internal_error","unprocessable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized","message":"Invalid or missing API key"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"Invalid or missing API key"}}}},"exampleType":"examples"}},"exampleType":"examples"},"8b9d64ea-4c8b-4a5a-8b2e-c0312266dbc2":{"description":"Must be a workspace admin to create a workspace template, or the chain step count exceeds the caller's plan limit (HAR-1098).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","not_found","validation_error","rate_limited","payment_required","transcript_revision_changed","internal_error","unprocessable"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"df3448de-fee5-4da1-ae28-dbf782e2212d":{"apiKey":{"type":"http","scheme":"bearer","description":"API key authentication. Pass your key as a Bearer token.\nKeys use the format `hm_live_\u003c32 hex chars>`.\nGenerate keys from your Harmonica dashboard settings.\n","scopes":[],"schemeName":"apiKey"}}},"servers":{"159ba40a-931d-4ff5-8f2f-ba0c710bfa77":{"url":"https://app.harmonica.chat/api/v1","description":"Production"},"3accf909-7c53-4e10-b168-fa6c780b47a7":{"url":"http://localhost:3000/api/v1","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key authentication. Pass your key as a Bearer token.\nKeys use the format `hm_live_\u003c32 hex chars>`.\nGenerate keys from your Harmonica dashboard settings.\n","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key authentication. Pass your key as a Bearer token.\nKeys use the format `hm_live_\u003c32 hex chars>`.\nGenerate keys from your Harmonica dashboard settings.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"harmonica","siteName":"Harmonica","title":"Create template - Harmonica","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T19:28:33.209Z","originalFileLocation":"api-reference/templates/create-template.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=\"Creates a template owned by the authenticated user. Private and user-scoped by default; provide workspace_id to create a workspace-scoped template (caller must be a workspace admin). Pass template_type: chain with a chain_config to install a chain method-spec (HAR-1098). Chain creation is subject to the same per-plan step cap as launching a chain (Free is capped; paid is unlimited).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Harmonica\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/harmonica/uKPo3EchCquppya6/_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/harmonica/uKPo3EchCquppya6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/harmonica/uKPo3EchCquppya6/_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/harmonica/uKPo3EchCquppya6/_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/harmonica/uKPo3EchCquppya6/_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/harmonica/uKPo3EchCquppya6/_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/harmonica/uKPo3EchCquppya6/_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/harmonica/uKPo3EchCquppya6/_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/harmonica/uKPo3EchCquppya6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create template - Harmonica\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a template owned by the authenticated user. Private and user-scoped by default; provide workspace_id to create a workspace-scoped template (caller must be a workspace admin). Pass template_type: chain with a chain_config to install a chain method-spec (HAR-1098). Chain creation is subject to the same per-plan step cap as launching a chain (Free is capped; paid is unlimited).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Harmonica\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.harmonica.chat/api-reference/templates/create-template\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://harmonica.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Create+template\u0026amp;description=Creates+a+template+owned+by+the+authenticated+user.+Private+and%0Auser-scoped+by+default%3B+provide+%60workspace_id%60+to+create+a%0Aworkspace-scoped+template+%28caller+mus\u0026amp;theme=a573403227a8ccedb8a9ea95\u0026amp;signature=d09d415b10d09254389317eb0a1924789c8a6561a76025897a3b440b449d06f1\">\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 - Harmonica\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a template owned by the authenticated user. Private and user-scoped by default; provide workspace_id to create a workspace-scoped template (caller must be a workspace admin). Pass template_type: chain with a chain_config to install a chain method-spec (HAR-1098). Chain creation is subject to the same per-plan step cap as launching a chain (Free is capped; paid is unlimited).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://harmonica.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Create+template\u0026amp;description=Creates+a+template+owned+by+the+authenticated+user.+Private+and%0Auser-scoped+by+default%3B+provide+%60workspace_id%60+to+create+a%0Aworkspace-scoped+template+%28caller+mus\u0026amp;theme=a573403227a8ccedb8a9ea95\u0026amp;signature=d09d415b10d09254389317eb0a1924789c8a6561a76025897a3b440b449d06f1\">\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/harmonica/uKPo3EchCquppya6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Harmonica\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1C1917\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.harmonica.chat/api-reference/templates/create-template\">\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-template.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.harmonica.chat/#organization\",\"name\":\"Harmonica\",\"url\":\"https://help.harmonica.chat\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/harmonica/aEc6kd8uk1Uw-f5Z/logo/light.svg?fit=max\u0026auto=format\u0026n=aEc6kd8uk1Uw-f5Z\u0026q=85\u0026s=53ddfa4a237729aac2f91dd80bacbdb6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.harmonica.chat#website\",\"name\":\"Harmonica\",\"url\":\"https://help.harmonica.chat\",\"publisher\":{\"@id\":\"https://help.harmonica.chat/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.harmonica.chat/api-reference/templates/create-template#webpage\",\"url\":\"https://help.harmonica.chat/api-reference/templates/create-template\",\"name\":\"Create template\",\"description\":\"Creates a template owned by the authenticated user. Private and user-scoped by default; provide workspace_id to create a workspace-scoped template (caller must be a workspace admin). Pass template_type: chain with a chain_config to install a chain method-spec (HAR-1098). Chain creation is subject to the same per-plan step cap as launching a chain (Free is capped; paid is unlimited).\",\"dateModified\":\"2026-10-31T19:28:33.209Z\",\"isPartOf\":{\"@id\":\"https://help.harmonica.chat#website\"},\"breadcrumb\":{\"@id\":\"https://help.harmonica.chat/api-reference/templates/create-template#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.harmonica.chat/api-reference/templates/create-template#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://help.harmonica.chat/api-reference/account/get-current-user\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create template\",\"item\":\"https://help.harmonica.chat/api-reference/templates/create-template\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.harmonica.chat/api-reference/templates/create-template#apireference\",\"headline\":\"Create template\",\"name\":\"Create template\",\"description\":\"Creates a template owned by the authenticated user. Private and user-scoped by default; provide workspace_id to create a workspace-scoped template (caller must be a workspace admin). Pass template_type: chain with a chain_config to install a chain method-spec (HAR-1098). Chain creation is subject to the same per-plan step cap as launching a chain (Free is capped; paid is unlimited).\",\"url\":\"https://help.harmonica.chat/api-reference/templates/create-template\",\"mainEntityOfPage\":{\"@id\":\"https://help.harmonica.chat/api-reference/templates/create-template#webpage\"},\"dateModified\":\"2026-10-31T19:28:33.209Z\",\"publisher\":{\"@id\":\"https://help.harmonica.chat/#organization\"},\"isPartOf\":{\"@id\":\"https://help.harmonica.chat#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Harmonica\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Harmonica","nav":{"global":{},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"MCP Server","href":"/api-reference/mcp-server"}]},{"group":"Endpoints","pages":[{"title":"Get current user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /me","href":"/api-reference/account/get-current-user"},{"title":"List templates","description":"Returns templates visible to the authenticated user: public global\ntemplates, templates they own, and (when `workspace_id` is provided and\nthey have access) that workspace's templates. Archived templates are excluded.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /templates","href":"/api-reference/templates/list-templates"},{"title":"Create template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /templates","href":"/api-reference/templates/create-template"},{"title":"Get template","description":"Returns a single template the caller can read.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /templates/{id}","href":"/api-reference/templates/get-template"},{"title":"Update template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /templates/{id}","href":"/api-reference/templates/update-template"},{"title":"Delete template","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /templates/{id}","href":"/api-reference/templates/delete-template"},{"title":"List projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /projects","href":"/api-reference/projects/list-projects"},{"title":"Create project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /projects","href":"/api-reference/projects/create-project"},{"title":"Get project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /projects/{id}","href":"/api-reference/projects/get-project"},{"title":"Update project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /projects/{id}","href":"/api-reference/projects/update-project"},{"title":"Delete project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /projects/{id}","href":"/api-reference/projects/delete-project"},{"title":"Attach meeting transcripts to a project in a bounded batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /projects/{id}/context-sources/meetings","href":"/api-reference/context-sources/attach-meeting-transcripts-to-a-project-in-a-bounded-batch"},{"title":"List owned meetings","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /meetings","href":"/api-reference/meetings/list-owned-meetings"},{"title":"Get meeting metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /meetings/{id}","href":"/api-reference/meetings/get-meeting-metadata"},{"title":"Get a bounded transcript page","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /meetings/{id}/transcript","href":"/api-reference/meetings/get-a-bounded-transcript-page"},{"title":"Export the complete current transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /meetings/{id}/transcript/export","href":"/api-reference/meetings/export-the-complete-current-transcript"},{"title":"Get meeting processing restrictions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /meetings/{id}/restrictions","href":"/api-reference/meetings/get-meeting-processing-restrictions"},{"title":"Update meeting processing restrictions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /meetings/{id}/restrictions","href":"/api-reference/meetings/update-meeting-processing-restrictions"},{"title":"Get project sensemaking topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /projects/{id}/sensemaking","href":"/api-reference/projects/get-project-sensemaking-topic"},{"title":"Publish project as sensemaking topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /projects/{id}/sensemaking","href":"/api-reference/projects/publish-project-as-sensemaking-topic"},{"title":"Create session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions","href":"/api-reference/sessions/create-session"},{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessions","href":"/api-reference/sessions/list-sessions"},{"title":"Get session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessions/{id}","href":"/api-reference/sessions/get-session"},{"title":"Inspect host-authorized chain state and blockers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessions/{id}/chain-state","href":"/api-reference/sessions/inspect-host-authorized-chain-state-and-blockers"},{"title":"Request guarded host chain progression","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/continue-chain","href":"/api-reference/sessions/request-guarded-host-chain-progression"},{"title":"Update session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /sessions/{id}","href":"/api-reference/sessions/update-session"},{"title":"Close session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/close","href":"/api-reference/sessions/close-session"},{"title":"Reopen session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/reopen","href":"/api-reference/sessions/reopen-session"},{"title":"Get session questions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessions/{id}/questions","href":"/api-reference/sessions/get-session-questions"},{"title":"Get session responses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessions/{id}/responses","href":"/api-reference/sessions/get-session-responses"},{"title":"Submit a response","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/responses","href":"/api-reference/sessions/submit-a-response"},{"title":"Get session brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessions/{id}/session-md","href":"/api-reference/sessions/get-session-brief"},{"title":"Get session summary","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /sessions/{id}/summary","href":"/api-reference/sessions/get-session-summary"},{"title":"Generate structured session knowledge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/knowledge","href":"/api-reference/sessions/generate-structured-session-knowledge"},{"title":"Seed or update scratchpad","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/scratchpad","href":"/api-reference/sessions/seed-or-update-scratchpad"},{"title":"Send chat message","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/chat","href":"/api-reference/chat/send-chat-message"},{"title":"Submit pre-session answers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /sessions/{id}/chat/questions","href":"/api-reference/chat/submit-pre-session-answers"}]},{"group":"Integrations","pages":[{"title":"List Telegram groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /integrations/telegram/groups","href":"/api-reference/integrations/list-telegram-groups"},{"title":"Register a Telegram group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /integrations/telegram/groups","href":"/api-reference/integrations/register-a-telegram-group"},{"title":"Unregister a Telegram group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml delete /integrations/telegram/groups/{groupId}","href":"/api-reference/integrations/unregister-a-telegram-group"}]}]}]},"basePath":"","title":"Create template - Harmonica","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}