---
title: "Create new internal document"
method: POST
path: "/v1/knowledge-models/{knowledge_model_id}/internal-documents"
---

# Create new internal document

`POST /v1/knowledge-models/{knowledge_model_id}/internal-documents`

Create new internal document and return it. Only model owner can manage internal documents.

## Path parameters

- `knowledge_model_id` string, required

## Request body

- InternalDocumentCreate
  - `name` string, required — Name of the internal document
  - `tags` object, nullable — Tags for the internal document
  - `priority` integer — Priority of the internal document
  - `in_use` boolean — Whether the internal document is in use

## Response `200`

Successful Response

- InternalDocumentSchema
  - `id` string, required — External ID of the internal document
  - `name` string, required — Name of the internal document
  - `tags` object, nullable — Tags for the internal document
  - `priority` integer, required — Priority of the internal document
  - `in_use` boolean, required — Whether the internal document is in use
  - `created_at` string, date-time, required — Creation timestamp
  - `updated_at` string, date-time, required — Last update timestamp

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