Mosaic

Overview

Mosaic is a comprehensive mental health knowledge platform that aggregates, structures, and provides programmatic access to clinical guidance, activities, and disorder classifications from authoritative sources worldwide.

Provides structured, version-controlled, and relationship-rich mental health data for professionals, researchers, and applications.

Key Features

Clinical Guidance Aggregation – Import guidelines from NICE UK, Child Mind Institute, and CAMHI
Disorder Classification – ICD-11 integrated taxonomy with hierarchical relationships
Activity Libraries – Structured assessments and interventions from providers like Curious
Dimensional Analysis – Map disorders to underlying mental health constructs
Multilingual Support – English, Greek, French, and Spanish localization
Knowledge Graph – Rich relationships between guides, disorders, and dimensions
AI-Powered Guide Generation – Create new guides by merging and adapting existing content

Access Points

Mosaic provides five ways to interact with mental health data, each optimized for different use cases.

CMS UI

Web-based admin panel for visual content management. Best for content editors, administrators, and manual data entry.

URL: /admin

Features: Draft/publish workflows, relationship management, media uploads, multilingual editing

Authentication: Email/password with role-based access control

Documentation: Payload Admin UI

REST API

HTTP endpoints for standard CRUD operations. Best for simple integrations, webhooks, and backend services.

Base URL: /api/:collection (e.g. /api/guide)

Operations: GET, POST, PATCH, DELETE with query parameters for filtering, sorting, pagination

Authentication: API key via Authorization header

Documentation: Payload REST API

TypeScript SDK

Type-safe client library wrapping the REST API. Best for TypeScript applications requiring full type safety and autocompletion.

Package: @mosaicdb/client

Features: Full TypeScript types, methods for find/create/update/delete, relationship depth control

Documentation: Payload SDK

GraphQL API

Flexible query language for complex data fetching. Best for frontend applications, mobile apps, and scenarios requiring precise data selection.

Endpoint: /api/graphql

Playground: /api/graphql-playground

Features: Query exactly what you need, nested relationships, efficient data loading, introspection

Documentation: Payload GraphQL

Mosaic API

Custom API for platform operations like data imports. Built with Hono and OpenAPI for type-safe client generation.

Base URL: /api/~

Swagger UI: /api/~/docs

Features: OpenAPI spec, Swagger UI, auto-generated TypeScript SDK, health checks, import triggers

Documentation: Hono Framework

Guide Generator

AI-powered tool for creating new guides by merging and adapting existing guide variants. Supports multiple AI providers.

URL: /guide-generator

Features: Source guide selection, AI provider choice (Anthropic, Google, OpenAI), language/fluency/length options

Authentication: API key with Reader and GuideGenerator roles

Requirement: AI provider API keys configured in user profile

Core Collections

Guide – Clinical guidance documents with evidence-based recommendations
Disorder – Mental health disorders from standardized classifications
Dimension – Mental health constructs (anxiety, mood, attention, etc.)
Activity – Assessments, interventions, and cognitive tasks
ActivityCollection – Organized groups of related activities
ActivityLibrary – Top-level organization of activity collections