---
title: "Update knowledge model settings"
method: PATCH
path: "/v1/knowledge-models/{knowledge_model_id}/settings"
---

# Update knowledge model settings

`PATCH /v1/knowledge-models/{knowledge_model_id}/settings`

Update knowledge model settings by its id

## Path parameters

- `knowledge_model_id` string, required

## Request body

- KnowledgeModelSettingsPatch
  - `system_message` KnowledgeModelSystemMessagePatch
    - `personality` string, nullable — System message that defines the model's personality and behavior.
    - `responses` string, nullable — System message that defines how model should respond
  - `documents_access` KnowledgeModelDocumentsAccessPatch
    - `webhook_url` string, uri, nullable — The URL for receiving a list of documents that are available for the user to access.

## Response `200`

Successful Response

- KnowledgeModelSettingsSchema
  - `system_message` SystemMessageSchema, required
    - `personality` string, required — System message that defines the model's personality and behavior.
    - `responses` string, required — System message that defines how model should respond
  - `documents_access` DocumentsAccessSchema, required
    - `webhook_url` string, nullable, required — The URL for receiving a list of documents that are available for the user to access.

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