---
title: "Creates a new knowledge model."
method: POST
path: "/v1/knowledge-models"
---

# Creates a new knowledge model.

`POST /v1/knowledge-models`

This endpoint initializes a new knowledge model for organizing and managing structured information.

## Request body

- KnowledgeModelCreate
  - `name` string, required — Name of the knowledge model.
  - `description` string, nullable — Optional description of the knowledge model.
  - `shared_type` 'all' | 'tenant' | 'private'
  - `share_documents` boolean — Flag to allow sharing documents with knowledge model depends on shared type

## Response `200`

Successful Response

- KnowledgeModelSchema
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `owner` IDMUserSchema, required
    - `user_id` string, uuid, required — User unique identifier
    - `tenant_id` string, uuid, required — User tenant unique identifier
  - `shared_type` 'all' | 'tenant' | 'private', required
  - `created_at` string, date-time, required
  - `share_documents` boolean, required

## 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)