Skip to main content
PATCH
Update 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.

Path Parameters

id
string<uuid>
required

Body

application/json

All fields optional; at least one must be provided.

title
string
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
template_type
enum<string>

Set to 'chain' to convert a single template into a chain (chain_config required) (HAR-1098).

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 re-install; the server stamps install_hash + timestamps (HAR-1108).

force
boolean

Overwrite a template that has local edits since install (HAR-1108).

Response

Updated template

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).