# Mirobody

## Docs

- [Family Sharing](https://docs.mirobody.ai/en/api-reference/authentication/beneficiary.md): /api/beneficiary-users + query_user_id
- [Email Login](https://docs.mirobody.ai/en/api-reference/authentication/email.md): /email/login + /email/verify two-step flow returning a long-lived JWT access_token
- [OAuth 2.0](https://docs.mirobody.ai/en/api-reference/authentication/oauth.md): SSO via authorization_code grant, or server-side via credentials grant
- [Token Refresh](https://docs.mirobody.ai/en/api-reference/authentication/refresh.md): Silently renew access_token using refresh_token before it expires
- [POST /api/chat](https://docs.mirobody.ai/en/api-reference/chat/chat.md): Streaming chat endpoint (SSE). Mirobody Platform's core integration entry point.
- [Custom System Prompt](https://docs.mirobody.ai/en/api-reference/chat/custom-prompt.md): CRUD for partner-saved system prompts; activated via prompt_name in /api/chat
- [History](https://docs.mirobody.ai/en/api-reference/chat/history.md): GET /api/history (list summaries or message detail), POST /api/history/delete
- [Sessions](https://docs.mirobody.ai/en/api-reference/chat/session.md): POST /api/session — explicitly create a session before chatting
- [Delete Files](https://docs.mirobody.ai/en/api-reference/files/delete.md): POST /api/v1/data/delete-files
- [List Uploaded Files](https://docs.mirobody.ai/en/api-reference/files/list.md): GET /api/v1/data/uploaded-files — also re-issues signed URLs
- [Upload Files](https://docs.mirobody.ai/en/api-reference/files/upload.md): POST /files/upload — multipart upload to OSS
- [Food Image Analysis](https://docs.mirobody.ai/en/api-reference/food/analyze.md): POST /api/v1/food/analyze — food image analysis (SSE streaming)
- [Save / History](https://docs.mirobody.ai/en/api-reference/food/save-history.md): Save a food recognition result, list history, delete
- [Categories & Sources](https://docs.mirobody.ai/en/api-reference/health-indicators/categories.md): GET /api/v1/holywell/health-indicator/categories
- [Data Distribution](https://docs.mirobody.ai/en/api-reference/health-indicators/distribution.md): GET /api/v1/data/data-distribution — per-category record counts and last update times
- [Latest Indicators](https://docs.mirobody.ai/en/api-reference/health-indicators/latest.md): GET /api/v1/holywell/health-indicator/watch/latest
- [Query Indicators](https://docs.mirobody.ai/en/api-reference/health-indicators/query.md): POST /api/v1/holywell/health-indicator/watch — filtering + semantic search
- [Create Journal](https://docs.mirobody.ai/en/api-reference/journal/create.md): POST /api/v1/holywell/journal/create — create a journal entry
- [List Journal Entries](https://docs.mirobody.ai/en/api-reference/journal/list.md): GET /api/v1/holywell/journal/list
- [Update / Delete / Reprocess Journal](https://docs.mirobody.ai/en/api-reference/journal/update-delete.md): Lifecycle operations on journal entries
- [MCP Protocol Overview](https://docs.mirobody.ai/en/api-reference/mcp/overview.md): Introduction to the Model Context Protocol interface
- [MCP Resources](https://docs.mirobody.ai/en/api-reference/mcp/resources.md): Available resources for AI agents via the MCP protocol
- [MCP Tools](https://docs.mirobody.ai/en/api-reference/mcp/tools.md): Available tools for AI agents via the MCP protocol
- [API Overview](https://docs.mirobody.ai/en/api-reference/overview.md): Common conventions: auth, response shell, SSE, rate limits, error codes
- [OAuth Callback](https://docs.mirobody.ai/en/api-reference/pulse/callback.md): OAuth callback endpoint for completing provider authentication
- [Link Provider](https://docs.mirobody.ai/en/api-reference/pulse/link.md): Initiate OAuth flow to link a user's health device account
- [List Providers](https://docs.mirobody.ai/en/api-reference/pulse/providers.md): Get a list of all available health device providers
- [Unlink Provider](https://docs.mirobody.ai/en/api-reference/pulse/unlink.md): Disconnect a user's health device account and revoke access
- [File Progress (WebSocket)](https://docs.mirobody.ai/en/api-reference/websocket/file-progress.md): wss /api/ws/file-progress — passive channel for parse progress events
- [Health Report Upload (WebSocket)](https://docs.mirobody.ai/en/api-reference/websocket/health-report.md): wss /ws/upload-health-report — large file upload with real-time progress
- [LLM Analysis Upload (WebSocket)](https://docs.mirobody.ai/en/api-reference/websocket/llm-analysis.md): wss /ws/upload-with-llm-analysis — end-to-end upload + LLM analysis
- [Compliance](https://docs.mirobody.ai/en/cloud/compliance.md): Independent CN / US deployments; both built to health-grade privacy standards
- [Quickstart](https://docs.mirobody.ai/en/cloud/quickstart.md): Get a token and make your first chat call in 5 minutes
- [Rate Limits](https://docs.mirobody.ai/en/cloud/rate-limits.md): Quota mechanism + client pacing
- [China Cluster](https://docs.mirobody.ai/en/cloud/regions/china.md): mcp.thetahealth.cn — Live
- [Global Cluster](https://docs.mirobody.ai/en/cloud/regions/global.md): 国际市场专属集群 — 上线中
- [Regions Overview](https://docs.mirobody.ai/en/cloud/regions/overview.md): Pick the cluster that matches your users
- [SDK Examples](https://docs.mirobody.ai/en/cloud/sdk-examples.md): End-to-end examples in curl / Python / Node.js
- [Architecture Overview](https://docs.mirobody.ai/en/concepts/architecture.md): How Mirobody is laid out: AI & agent engine, FHIR + health standards, data pipeline, and infrastructure.
- [Data Flow](https://docs.mirobody.ai/en/concepts/data-flow.md): Understanding how health data flows through the Mirobody system
- [File Processing](https://docs.mirobody.ai/en/concepts/file-processing.md): Upload and process health documents, lab reports, and medical records
- [Provider System](https://docs.mirobody.ai/en/concepts/providers.md): Deep dive into the Mirobody provider system architecture
- [Configuration](https://docs.mirobody.ai/en/configuration.md): Complete configuration guide for Mirobody: OAuth, AI providers, agents, MCP exposure, storage, and security.
- [Docker Deployment](https://docs.mirobody.ai/en/deployment/docker.md): Deploy Mirobody using Docker and Docker Compose
- [Production Deployment](https://docs.mirobody.ai/en/deployment/production.md): Best practices for deploying Mirobody to production
- [Contributing](https://docs.mirobody.ai/en/development/contributing.md): Guidelines for contributing to Mirobody
- [Data Mapping](https://docs.mirobody.ai/en/development/data-mapping.md): Transform vendor-specific health data into standardized indicators
- [File Processing Implementation](https://docs.mirobody.ai/en/development/file-processing.md): Technical documentation for file upload, processing, and health indicator extraction
- [OAuth Implementation](https://docs.mirobody.ai/en/development/oauth-implementation.md): Implementing OAuth 1.0 and OAuth 2.0 flows for provider integrations
- [Building Custom Providers](https://docs.mirobody.ai/en/development/provider-integration.md): Complete guide to integrating new health device APIs into Mirobody
- [Provider Testing](https://docs.mirobody.ai/en/development/provider-testing.md): Testing strategies for custom provider integrations
- [Development Setup](https://docs.mirobody.ai/en/development/setup.md): Set up your local development environment for Mirobody
- [Testing Guide](https://docs.mirobody.ai/en/development/testing.md): Testing practices and guidelines for Mirobody
- [Garmin Provider Example](https://docs.mirobody.ai/en/examples/garmin-provider.md): Complete implementation example of the Garmin Connect provider
- [Whoop Provider Example](https://docs.mirobody.ai/en/examples/whoop-provider.md): Complete implementation example of the Whoop provider
- [Welcome to Mirobody](https://docs.mirobody.ai/en/index.md): An open-source, self-hosted data engine that bridges your personal data with the latest AI. This documentation covers Mirobody's health vertical, the foundation of Theta Wellness.
- [Installation](https://docs.mirobody.ai/en/installation.md): Detailed installation instructions for Mirobody on various platforms
- [Provider Overview](https://docs.mirobody.ai/en/providers/overview.md): Understanding the provider system in Mirobody and how it integrates with health device APIs
- [Using Providers](https://docs.mirobody.ai/en/providers/using-providers.md): Connect wearables, mobile health platforms, and EHR sources to Mirobody
- [Quick Start](https://docs.mirobody.ai/en/quickstart.md): Get Mirobody running locally in under 5 minutes with one command.
- [Adding Custom MCPs](https://docs.mirobody.ai/en/tools/adding-mcps.md): Connect third-party MCP servers to extend your AI agent's capabilities
- [Adding Custom Tools](https://docs.mirobody.ai/en/tools/adding-tools.md): Learn how to create custom tools for AI agents in Mirobody
- [Built-in Tools](https://docs.mirobody.ai/en/tools/built-in.md): Default health tools provided by Mirobody
- [ChatGPT Apps](https://docs.mirobody.ai/en/tools/chatgpt-apps.md): Expose Mirobody as a ChatGPT App via the HTTP Remote MCP server
- [Mirobody MCP Server](https://docs.mirobody.ai/en/tools/mcp-integration.md): Connect Mirobody tools to Claude, Cursor, ChatGPT, and other MCP clients
- [Tools & Agents Overview](https://docs.mirobody.ai/en/tools/overview.md): Understanding agents, tools, and MCP integration in Mirobody
- [Writing a Skill](https://docs.mirobody.ai/en/tools/skills-guide.md): Drop a SKILL.md + metadata.json into skills/ and your agent picks it up automatically.
- [Use Cases & Examples](https://docs.mirobody.ai/en/use-cases.md): What Mirobody can do for personal health — real conversations on synthetic data.

## OpenAPI Specs

- [openapi](https://docs.mirobody.ai/zh/api-reference/openapi.json)

## Optional

- [Theta Wellness App](https://www.thetahealth.ai/)
- [GitHub](https://github.com/thetahealth/mirobody)
- [X (Twitter)](https://x.com/thetawellnessai)
- [LinkedIn](https://www.linkedin.com/company/trythetahealth)