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.

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)