# Harmonica

## Docs

- [Get current user](https://help.harmonica.chat/api-reference/account/get-current-user.md): Returns user info and API key metadata for the authenticated user.
- [Send chat message](https://help.harmonica.chat/api-reference/chat/send-chat-message.md): Send a message to a session's AI facilitator as a specific participant. The facilitator responds in a conversational style, guiding the participant through the deliberation topic. When the facilitator considers the conversation complete, `is_final` is set to `true`.
- [Submit pre-session answers](https://help.harmonica.chat/api-reference/chat/submit-pre-session-answers.md): Submit answers to a session's pre-session questions and receive the facilitator's opening message. This starts the facilitation for the participant.
- [List Telegram groups](https://help.harmonica.chat/api-reference/integrations/list-telegram-groups.md): List Telegram groups registered to the authenticated user's account.
- [Register a Telegram group](https://help.harmonica.chat/api-reference/integrations/register-a-telegram-group.md): Register or update a Telegram group on the authenticated user's account. If the group is already registered (same user + group_id), the name and topic_id are updated. Called by the Telegram bot during `/setup`.
- [Unregister a Telegram group](https://help.harmonica.chat/api-reference/integrations/unregister-a-telegram-group.md): Remove a Telegram group from the authenticated user's account.
- [API Reference](https://help.harmonica.chat/api-reference/introduction.md): REST API for programmatic access to Harmonica sessions
- [MCP Server](https://help.harmonica.chat/api-reference/mcp-server.md): Connect AI agents to Harmonica via Model Context Protocol
- [List public sessions](https://help.harmonica.chat/api-reference/public/list-public-sessions.md): Returns active sessions that hosts have marked as publicly accessible. No authentication required. Rate-limited by IP address (100 req/min). Use this endpoint to discover participation opportunities.
- [Create session](https://help.harmonica.chat/api-reference/sessions/create-session.md): Creates a new deliberation session owned by the authenticated user. If `prompt` is omitted, a facilitation prompt is auto-generated server-side from the topic, goal, context, and critical fields (with a fallback to a basic prompt). Returns the created session with a `join_url` for sharing with parti…
- [Get session](https://help.harmonica.chat/api-reference/sessions/get-session.md): Returns full details of a session the user has access to.
- [Get session brief](https://help.harmonica.chat/api-reference/sessions/get-session-brief.md): Returns the structured SESSION.md brief as raw markdown. Auto-generated after summary creation. Returns 404 if not yet generated.
- [Get session questions](https://help.harmonica.chat/api-reference/sessions/get-session-questions.md): Returns the facilitation questions/prompts for a session.
- [Get session responses](https://help.harmonica.chat/api-reference/sessions/get-session-responses.md): Returns all participant responses for a session, grouped by participant. Each participant's conversation thread includes both user messages and assistant (facilitator) messages.
- [Get session summary](https://help.harmonica.chat/api-reference/sessions/get-session-summary.md): Returns the AI-generated summary for a completed session. Returns null summary if the session hasn't been summarized yet.
- [List sessions](https://help.harmonica.chat/api-reference/sessions/list-sessions.md): Returns sessions the authenticated user has access to (owns or participates in). Results are ordered by most recently updated first.
- [Seed or update scratchpad](https://help.harmonica.chat/api-reference/sessions/seed-or-update-scratchpad.md): Trigger cross-pollination scratchpad seeding or update for a session. The scratchpad tracks themes, emerging consensus, open tensions, and well-covered questions across all participant conversations.
- [Submit a response](https://help.harmonica.chat/api-reference/sessions/submit-a-response.md): Submit a response to an active session as the authenticated user. The session must be active and the user must have at least editor access.
- [Update session](https://help.harmonica.chat/api-reference/sessions/update-session.md): Update session metadata. At least one field must be provided. Requires editor role or higher on the session.
- [Frequently Asked Questions](https://help.harmonica.chat/faq.md): Common questions about Harmonica
- [Bring Your Own Model (BYOM)](https://help.harmonica.chat/guides/hosts/byom.md): Use your own AI API keys to power Harmonica with any supported model
- [Collaboration](https://help.harmonica.chat/guides/hosts/collaboration.md): Share sessions and projects with your team
- [Creating Sessions](https://help.harmonica.chat/guides/hosts/creating-sessions.md): Learn how to create and manage Harmonica sessions
- [Managing Projects](https://help.harmonica.chat/guides/hosts/managing-projects.md): Organize and manage sessions within projects
- [Session Results](https://help.harmonica.chat/guides/hosts/session-results.md): Review summaries, responses, and insights from your sessions
- [Session Settings](https://help.harmonica.chat/guides/hosts/session-settings.md): Configure session behavior, sharing, and invitations
- [Templates](https://help.harmonica.chat/guides/hosts/templates.md): Use pre-built templates to create sessions quickly
- [Participating in a Session](https://help.harmonica.chat/guides/participants/participating-in-sessions.md): Learn how to join and contribute to Harmonica sessions
- [Welcome to Harmonica](https://help.harmonica.chat/index.md): Conversational survey platform for qualitative insights and group coordination
- [Data Privacy & Security](https://help.harmonica.chat/privacy.md): How Harmonica handles your data, where it's stored, and your options for control
- [Quickstart](https://help.harmonica.chat/quickstart.md): Get started with Harmonica in minutes

## OpenAPI Specs

- [openapi](https://help.harmonica.chat/api-reference/openapi.yaml)