List Harmonica deliberation sessions you have access to

Get details of a specific Harmonica session

List participants in a Harmonica session with metadata (name, message count, timestamps) but WITHOUT full conversations. Use this first to find participants, then get_responses with filters for specific ones.

Get participant responses for a Harmonica session. Returns full conversation threads. Use filters to avoid fetching all data at once for large sessions.

Get the AI-generated summary for a Harmonica session

Generate or regenerate the AI summary for a Harmonica session. Uses the session's custom summary_prompt if set, otherwise the default. Requires editor role.

Search Harmonica sessions by topic or goal keywords

Get pre-session questions (data collection form) for a Harmonica session

Create a new Harmonica deliberation session and get a shareable join URL

Update session metadata. Mirrors the v1 PATCH /api/v1/sessions/[id] ALLOWED_UPDATE_FIELDS surface. Requires editor role.

List Telegram groups registered to your Harmonica account for session distribution

List Harmonica session templates available to your account (public global templates + templates you own / can access). Use to discover what facilitation patterns are configured in the platform — pass the returned id to create_session as template_id to launch a session with that template's stored facilitation_prompt. Returns id, title, description, and template_type (single | chain) for each.

Send a message in a Harmonica session conversation and get the AI facilitator response. Creates a new participant thread if first message.

Submit pre-session question answers and start a facilitated conversation. Returns the opening facilitator message.

Install an OFL method spec (the contents of a method.md file) as a runnable Harmonica chain template. Pass the full method.md text as method_md. Use dry_run to preview the generated chain_config without writing anything. Chain templates need a paid (Pro/LTD) account; Free is capped at 3 steps.

Create a Harmonica project (workspace) you own. Use the returned project ID to publish it as a public sensemaking topic via publish_sensemaking_topic, or to scope sessions/templates to the project. Reuse an existing project by passing its ID to those tools instead of creating a new one.

List the Harmonica projects (workspaces) you have access to. A project groups related sessions and can be published as a public sensemaking topic. Returns title + id for each.

Get a single Harmonica project (workspace) by id, including the ids of the sessions linked to it.

Rename a Harmonica project (workspace) or update its description. Requires editor access. Pass at least one of title / description.

Soft-delete a Harmonica project (workspace): it is archived (status=deleted) and the sessions inside it are left intact, just ungrouped. Requires owner access. This never deletes any sessions.

Author and publish a Harmonica project as a public sensemaking topic — the /explore hub entry + the /t/[slug] opinion-landscape page built from the project's sessions. Pass enabled: true with a slug (here or already saved) to publish. Requires editor access to the project. Listing on /explore is a separate admin-curated step.