Create a new chat
Creates a new chat configuration. The authenticated user becomes the owner. Requires admin, contributor, or page-owner role.
Each entry in dataSources[] may include a datasourceId referencing a
DataSourceCatalog entity. All datasourceId references are validated
against the datasources catalog — invalid references return 400.
Authorizations
Azure AD access token obtained via MSAL
Body
Chat tab configuration with multi-source RAG, ACL, and feature flags
Chat ID (UUID)
Access control model
personal, shared UPN of the creator
Allow public read access
Hide entity from user-facing recommendations and catalog/search surfaces (still accessible to owners/contributors/admins)
ISO-8601 creation timestamp
ISO-8601 update timestamp
Markdown-formatted instructions displayed in the chat canvas
MUI icon name for navigation display
Array of data sources for multi-source RAG (empty = LLM only)
Remove duplicate docs across sources
How to merge multi-source results
interleave, weighted, sequential When true, only admins/owners/contributors see files and citations
When true, shows only chat canvas without navigation elements
When true, hides the prompt selector on the canvas
FK to AI model endpoint
FK to AI Search endpoint
basic, premium FK to Page for dynamic navigation
FK to prompt group for curated prompt templates
AI inference options — undefined means use system defaults
Scopes to read memories from (includes orgGlobal for admin-managed memories)
userGlobal, userChat, orgGlobal, orgChat Scope to write new memories to (excludes orgGlobal — admin only)
userGlobal, userChat, orgGlobal, orgChat Max % of model context for memory (1-20%, default: 5%)
semantic, recency, hybrid, semantic_keyword, all Lock User's Private Memories (USER_GLOBAL) — users cannot disable
Lock User's Private Chat Memories (USER_CHAT) — users cannot disable
Lock This Chat's Shared Memories (ORG_CHAT) — users cannot disable
FK to FlowEngine flow
Show entry prompt form on chat start to collect flow variables
Pre-filled values for flow entry prompt variables
Variable names that end users cannot override
Variable names hidden from end users at runtime
When true and all variables are locked+filled, skip entry prompt
Array of MCP server IDs enabled for this chat
Per-chat config overrides for MCP servers
Whether this chat is featured/promoted in the catalog
ASSIGNMENT_COMPLETION_CRITERIA — default completion criteria for assignments
Server-only: true when request targets the ephemeral cross-chat workspace. Never persisted.
Response
Chat created
Chat tab configuration with multi-source RAG, ACL, and feature flags
Chat ID (UUID)
Access control model
personal, shared UPN of the creator
Allow public read access
Hide entity from user-facing recommendations and catalog/search surfaces (still accessible to owners/contributors/admins)
ISO-8601 creation timestamp
ISO-8601 update timestamp
Markdown-formatted instructions displayed in the chat canvas
MUI icon name for navigation display
Array of data sources for multi-source RAG (empty = LLM only)
Remove duplicate docs across sources
How to merge multi-source results
interleave, weighted, sequential When true, only admins/owners/contributors see files and citations
When true, shows only chat canvas without navigation elements
When true, hides the prompt selector on the canvas
FK to AI model endpoint
FK to AI Search endpoint
basic, premium FK to Page for dynamic navigation
FK to prompt group for curated prompt templates
AI inference options — undefined means use system defaults
Scopes to read memories from (includes orgGlobal for admin-managed memories)
userGlobal, userChat, orgGlobal, orgChat Scope to write new memories to (excludes orgGlobal — admin only)
userGlobal, userChat, orgGlobal, orgChat Max % of model context for memory (1-20%, default: 5%)
semantic, recency, hybrid, semantic_keyword, all Lock User's Private Memories (USER_GLOBAL) — users cannot disable
Lock User's Private Chat Memories (USER_CHAT) — users cannot disable
Lock This Chat's Shared Memories (ORG_CHAT) — users cannot disable
FK to FlowEngine flow
Show entry prompt form on chat start to collect flow variables
Pre-filled values for flow entry prompt variables
Variable names that end users cannot override
Variable names hidden from end users at runtime
When true and all variables are locked+filled, skip entry prompt
Array of MCP server IDs enabled for this chat
Per-chat config overrides for MCP servers
Whether this chat is featured/promoted in the catalog
ASSIGNMENT_COMPLETION_CRITERIA — default completion criteria for assignments
Server-only: true when request targets the ephemeral cross-chat workspace. Never persisted.