---
title: "Create new chat session via API"
method: POST
path: "/v1/knowledge-models/{knowledge_model_id}/chat-sessions"
---

# Create new chat session via API

`POST /v1/knowledge-models/{knowledge_model_id}/chat-sessions`

Create a new chat session via API

## Path parameters

- `knowledge_model_id` string, required

## Request body

- ChatSessionCreateAPI
  - `llm_id` string, nullable — Language model identifier
  - `mode` 'model' | 'direct' | 'blended'

## Response `200`

Successful Response

- ChatSessionSchema
  - `id` string, required
  - `name` string, required
  - `knowledge_model_id` string, required
  - `llm_id` string, required
  - `extension` 'explorer' | 'optative_rag' | 'conference_assistant' | 'food_safety_assistant' | 'digital_twin' | 'direct_llm' | 'compliance_assistant' | 'pandasai' | 'career_adviser' | 'extended_rag' | 're_act_km_chat' | 'lms_search' | 'avatar', required
  - `included_documents` ChatSessionDocumentSchema[]
    - `id` string, required
    - `filename` string, required
    - `chat_session_id` string, required
    - `updated_at` string, date-time, required
    - `deleted` boolean
  - `session_origin` 'UI' | 'API' | 'STATELESS_API' | 'WIDGET' | 'INDEXING', required
  - `mode` 'model' | 'direct' | 'blended'

## Other responses

- `401` — User token is not present in cookies or has incorrect value.
- `421` — Various errors, see examples
- `422` — Validation Error

---

[API](https://skmtc.dev/constructor-tech/apis/constructorknowledgemodel.md) · [All operations](https://skmtc.dev/constructor-tech/apis/constructorknowledgemodel/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor-tech/constructorknowledgemodel/revisions/989f1fae00de/schema)