# Handa Uncle Platform ## Docs - [Claude Code prompts](https://docs.handauncle.com/ai-tools/claude-code.md): Using Anthropic's CLI to reason about large diffs - [Cursor workflow](https://docs.handauncle.com/ai-tools/cursor.md): Shared rules for using Cursor with the Handa Uncle backend - [Windsurf setup](https://docs.handauncle.com/ai-tools/windsurf.md): Cascade workspace rules for Handa Uncle development - [AI Chat API](https://docs.handauncle.com/api-reference/ai.md): Unified LLM chat service with streaming, attachments, and device-auth guests. - [Send Chat Message](https://docs.handauncle.com/api-reference/ai/chat.md): Unified chat endpoint for the Handa Uncle assistant. - [AI Service Health](https://docs.handauncle.com/api-reference/ai/health.md): Returns provider, model, and capability metadata for the AI router. - [Auth API](https://docs.handauncle.com/api-reference/auth.md): Email/password, Google OAuth, token refresh, phone OTP, and webhooks - [Google OAuth (Token Exchange)](https://docs.handauncle.com/api-reference/auth/google-token.md) - [Auth Service Health](https://docs.handauncle.com/api-reference/auth/health.md) - [Current User Profile](https://docs.handauncle.com/api-reference/auth/me.md): Returns the complete user profile overview including user data, usage statistics (conversations, shares), and profile context (static, recent, frequent cues). Auto-creates user if not exists. - [Refresh Access Token](https://docs.handauncle.com/api-reference/auth/refresh.md) - [Resend OTP](https://docs.handauncle.com/api-reference/auth/resend-otp.md) - [Send OTP](https://docs.handauncle.com/api-reference/auth/send-otp.md) - [Sign Out](https://docs.handauncle.com/api-reference/auth/signout.md) - [Update Profile](https://docs.handauncle.com/api-reference/auth/update-me.md): Updates the authenticated user's profile. Supports both JSON and multipart/form-data. Use multipart/form-data to upload an avatar image along with profile updates. Images larger than 1MB are automatically compressed. Use _clearAvatar: true to remove the avatar. - [Verify OTP](https://docs.handauncle.com/api-reference/auth/verify-otp.md) - [Post-Login Webhook (Legacy)](https://docs.handauncle.com/api-reference/auth/webhook-post-login.md) - [Post-Registration Webhook](https://docs.handauncle.com/api-reference/auth/webhook-post-registration.md) - [Chat Share API](https://docs.handauncle.com/api-reference/chat-share.md): Create public links for conversations, manage access, and surface analytics. - [Share Analytics](https://docs.handauncle.com/api-reference/chat-share/analytics.md) - [Continue Shared Conversation](https://docs.handauncle.com/api-reference/chat-share/continue.md) - [Create Share Link](https://docs.handauncle.com/api-reference/chat-share/create.md) - [List Share Links](https://docs.handauncle.com/api-reference/chat-share/list.md) - [Revoke Share](https://docs.handauncle.com/api-reference/chat-share/revoke.md) - [Update Share](https://docs.handauncle.com/api-reference/chat-share/update.md) - [View Shared Conversation](https://docs.handauncle.com/api-reference/chat-share/view.md) - [Conversations API](https://docs.handauncle.com/api-reference/conversations.md): Authenticated history, metadata, and lifecycle management for user conversations. - [Archive Conversation](https://docs.handauncle.com/api-reference/conversations/archive.md): Move a conversation to archived status. Supports both Auth0 JWT and device-based authentication. - [Delete Conversation](https://docs.handauncle.com/api-reference/conversations/delete.md) - [Get Conversation Details](https://docs.handauncle.com/api-reference/conversations/details.md): Fetch detailed metadata about a specific conversation. Supports both Auth0 JWT and device-based authentication. - [List Conversations](https://docs.handauncle.com/api-reference/conversations/list.md): Returns the authenticated user's conversations ordered by recency with optional status filtering, pagination, and search. Use the `q` parameter to search by title or preview. Supports both Auth0 JWT and device-based authentication. - [Submit Message Feedback](https://docs.handauncle.com/api-reference/conversations/message-feedback.md): Submit user feedback (thumbs up/down and optional text) for a message. Supports both Auth0 JWT and device-based authentication for guest users. - [List Messages in Conversation](https://docs.handauncle.com/api-reference/conversations/messages.md): Retrieve paginated message history for a conversation. Supports both Auth0 JWT and device-based authentication. - [Restore Conversation](https://docs.handauncle.com/api-reference/conversations/restore.md): Restore an archived conversation to active status. Supports both Auth0 JWT and device-based authentication. - [Update Conversation](https://docs.handauncle.com/api-reference/conversations/update.md) - [App Configuration](https://docs.handauncle.com/api-reference/endpoint/app-config.md): Returns both system URLs and social media URLs configuration. - [Get Social Media URLs](https://docs.handauncle.com/api-reference/endpoint/app-config-social-urls.md): Returns social media URLs for Facebook, Instagram, LinkedIn, and Twitter. - [Get System URLs](https://docs.handauncle.com/api-reference/endpoint/app-config-system-urls.md): Returns system URLs like terms and conditions, privacy policy, FAQs, and support email. - [Update Social Media URLs](https://docs.handauncle.com/api-reference/endpoint/app-config-update-social-urls.md): Admin endpoint to update social media URLs. Requires BACKEND_SECRET for authentication. - [Update System URLs](https://docs.handauncle.com/api-reference/endpoint/app-config-update-system-urls.md): Admin endpoint to update system URLs. Requires BACKEND_SECRET for authentication. - [App Service Health](https://docs.handauncle.com/api-reference/endpoint/app-health.md): Lightweight readiness endpoint exposed by the `/app` router for smoke tests and monitoring. - [App Launch](https://docs.handauncle.com/api-reference/endpoint/app-launch.md): Resolves the caller to a user (if possible), updates device metadata, and returns onboarding, usage, auth state, and link information required to render the home screen. Supports optional Authorization header to return token expiry info and validate device-user mapping for silent refresh flows. - [Platform Health](https://docs.handauncle.com/api-reference/endpoint/platform-health.md): Aggregates MongoDB, Redis, and subsystem readiness and is used by load balancers for health checking. - [File Upload API](https://docs.handauncle.com/api-reference/files.md): Upload images or PDFs, list prior uploads, and manage attachments. - [Delete File](https://docs.handauncle.com/api-reference/files/delete.md) - [Get File Metadata](https://docs.handauncle.com/api-reference/files/get.md) - [List Files](https://docs.handauncle.com/api-reference/files/list.md) - [Upload File](https://docs.handauncle.com/api-reference/files/upload.md) - [Handa Uncle API](https://docs.handauncle.com/api-reference/introduction.md): Overview of the Handa Uncle platform and mobile APIs - [PrePrompt Management](https://docs.handauncle.com/api-reference/preprompts.md): Admin endpoints for defining masked pre-prompts plus the public catalog used by clients. - [Create PrePrompt](https://docs.handauncle.com/api-reference/preprompts/create.md): Creates a masked pre-prompt. Requires the backend secret via `Authorization: Bearer ` or `X-Backend-Secret: `. - [Delete PrePrompt](https://docs.handauncle.com/api-reference/preprompts/delete.md): Marks a pre-prompt as deleted. - [List PrePrompts](https://docs.handauncle.com/api-reference/preprompts/list.md): Returns all pre-prompts. Requires backend secret headers. - [List Public PrePrompts](https://docs.handauncle.com/api-reference/preprompts/public.md): Returns the user-facing catalog; no authentication required. - [Update PrePrompt](https://docs.handauncle.com/api-reference/preprompts/update.md): Updates key/value pairs for an existing pre-prompt. - [Second Opinion PrePrompts](https://docs.handauncle.com/api-reference/second-opinion-preprompts.md): Admin endpoints for managing Second Opinion suggestion cards and the public catalog for clients. - [Create Preprompt (Admin)](https://docs.handauncle.com/api-reference/second-opinion/create.md): Create a new Second Opinion suggestion card. - [Delete Preprompt (Admin)](https://docs.handauncle.com/api-reference/second-opinion/delete.md): Delete a Second Opinion preprompt. - [Get Preprompt (Admin)](https://docs.handauncle.com/api-reference/second-opinion/get.md): Get a specific Second Opinion preprompt by ID. - [List Preprompts (Admin)](https://docs.handauncle.com/api-reference/second-opinion/list.md): List all Second Opinion preprompts. - [Get Public Catalog](https://docs.handauncle.com/api-reference/second-opinion/public.md): Get the public catalog of Second Opinion suggestion cards. - [Update Preprompt (Admin)](https://docs.handauncle.com/api-reference/second-opinion/update.md): Update an existing Second Opinion preprompt. - [User Profile API](https://docs.handauncle.com/api-reference/user-profile.md): Profile card collection and user data for personalized AI responses. - [Get User Profile](https://docs.handauncle.com/api-reference/user-profile/get.md): Returns user profile data and current cards to show. - [Get Current Cards](https://docs.handauncle.com/api-reference/user-profile/get-cards.md): Get current cards to show without starting a session. - [Save Profile Answers](https://docs.handauncle.com/api-reference/user-profile/save-answers.md): Store user responses to profile cards. - [Start Profile Session](https://docs.handauncle.com/api-reference/user-profile/start-session.md): Begin new session and advance cards. - [Visual Embeds API](https://docs.handauncle.com/api-reference/visual-embeds.md): Manage visual embed images that attach to AI chat responses. - [Bulk Create Visual Embeds](https://docs.handauncle.com/api-reference/visual-embeds/bulk-create.md): Add multiple visual embeds at once. - [List Categories](https://docs.handauncle.com/api-reference/visual-embeds/categories.md): Get all visual embed categories. - [Create Visual Embed](https://docs.handauncle.com/api-reference/visual-embeds/create.md): Add a new visual embed. - [Delete Visual Embed](https://docs.handauncle.com/api-reference/visual-embeds/delete.md): Remove a visual embed. - [Get Visual Embed](https://docs.handauncle.com/api-reference/visual-embeds/get.md): Get a single visual embed by ID. - [List Visual Embeds](https://docs.handauncle.com/api-reference/visual-embeds/list.md): Get all visual embeds, optionally filter by category. - [Update Visual Embed](https://docs.handauncle.com/api-reference/visual-embeds/update.md): Modify an existing visual embed. - [App Configuration Management](https://docs.handauncle.com/codebase/app-configuration.md): Manage system URLs and social media links dynamically - [Codebase architecture](https://docs.handauncle.com/codebase/architecture.md): How the Bun + Hono backend is wired together and where to look first. - [CI/CD Pipeline](https://docs.handauncle.com/codebase/cicdpipeline.md): Continuous Integration and Deployment workflow for HandaUncle Backend - [Core backend workflows](https://docs.handauncle.com/codebase/core-workflows.md): Step-by-step references for the paths every Handa Uncle developer touches. - [PrePrompts Collection](https://docs.handauncle.com/codebase/preprompts.md): MongoDB schema and storage notes for masked pre-prompts. - [Service catalog](https://docs.handauncle.com/codebase/service-catalog.md): What lives under src/services and how each module interacts with shared plumbing. - [Environment configuration](https://docs.handauncle.com/codebase/settings.md): Variables enforced by env.schema.ts - [Commit Message Guide](https://docs.handauncle.com/contributing/commit-guide.md): Conventional commit standards for HandaUncle repositories - [Git Fundamentals](https://docs.handauncle.com/contributing/git-fundamentals.md): Essential Git concepts and terminology explained - [Git Branching & Workflow](https://docs.handauncle.com/contributing/git-workflow.md): Git branching strategy and workflow best practices - [Developer workflow](https://docs.handauncle.com/development.md): Standards for contributing to the Handa Uncle backend - [Code and API examples](https://docs.handauncle.com/essentials/code.md): How we present commands, requests, and responses - [Screenshots and media](https://docs.handauncle.com/essentials/images.md): Asset guidelines for Handa Uncle docs - [Writing playbook](https://docs.handauncle.com/essentials/markdown.md): Voice, structure, and review standards for Handa Uncle docs - [Docs navigation](https://docs.handauncle.com/essentials/navigation.md): How we organize guides inside docs.json - [Reusable snippets](https://docs.handauncle.com/essentials/reusable-snippets.md): Shared copy blocks for compliance, support, and CTAs - [Handa Uncle Platform](https://docs.handauncle.com/index.md): Architecture, operations, and API guides for the Handa Uncle wealth assistant - [Local development quickstart](https://docs.handauncle.com/quickstart.md): Bring up the Handa Uncle backend on your laptop in under 10 minutes ## OpenAPI Specs - [openapi](https://docs.handauncle.com/api-reference/openapi.json) ## Optional - [Handa Uncle](https://www.handauncle.com) - [Status](https://status.handauncle.com) - [Prod API Base URL](https://handauncle-backend-prod-205012263523.asia-south1.run.app)