Skip to main content
POST
Create template

Authorizations

Authorization
string
header
required

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.

Body

application/json
title
string
required
description
string | null
icon
string | null
facilitation_prompt
string | null
default_session_name
string | null
default_goal
string | null
default_critical
string | null
default_context
string | null
is_public
boolean
default:false
workspace_id
string | null

When set, creates a workspace-scoped template (caller must be a workspace admin).

template_type
enum<string>

Pass 'chain' (with chain_config) to install a chain method-spec (HAR-1098). Defaults to 'single'.

Available options:
single,
chain
chain_config
object

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.

source_provenance
object

Spec identity for a registry install; the server stamps install_hash + timestamps (HAR-1108).

Response

Template created

id
string<uuid>
required
title
string
required
template_type
string
required

single or chain

cross_pollination_default
boolean
required
is_public
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
description
string | null
icon
string | null
facilitation_prompt
string | null
default_session_name
string | null
default_goal
string | null
default_critical
string | null
default_context
string | null
chain_config
object | null

Chain definition for chain templates; null for single templates (HAR-1098).

workspace_id
string<uuid> | null
created_by
string | null
archived_at
string<date-time> | null
source_provenance
object | null

Provenance for a template installed from the OFL method-specs registry; null for admin-authored templates (HAR-1108).