Skip to main content
PATCH
Update session

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

Session ID

Body

application/json
topic
string
goal
string
context
string
critical
string
prompt
string

Custom facilitation prompt for the AI facilitator

project_id
string | null

Move the session into a project, or pass null to detach it from all projects. Requires editor access to the target project.

results_visibility
enum<string>

Who can see aggregated session results. See CreateSessionRequest.results_visibility for the first three tiers.

community opens results to members of the organization the session's project is bound to, in addition to the people who took part — it is additive, never a replacement. It is validated against the project the session will LAND in, so sending it together with a project_id that is not bound to an organization, or with project_id: null, is rejected with validation_error.

Available options:
public,
participants,
community,
host

Response

Updated session

id
string<uuid>
required
topic
string
required
goal
string
required
status
enum<string>
required
Available options:
active,
completed
participant_count
integer
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
critical
string | null
context
string | null
prompt
string | null

Custom facilitation prompt for the session's AI facilitator

summary
string | null
session_md
string | null

Structured SESSION.md brief (auto-generated after summary)