---
title: "Update Knowledge Base Route"
method: PUT
path: "/api/knowledge_bases/{knowledge_base_id}"
tags: ["knowledge_base"]
---

# Update Knowledge Base Route

`PUT /api/knowledge_bases/{knowledge_base_id}`

Update a knowledge base.

## Path parameters

- `knowledge_base_id` string, uuid, required

## Request body

- KnowledgeBaseWithConfigUpdate — KnowledgeBase update model with config -- used for updating an existing knowledge_base with config.
  - `ingestion_pipeline_params` KnowledgeBasePipelineParamsInput, required — Knowledge base pipeline params. Parameters defined on the knowledge-base level for a pipeline.
    - `curate` CurateParams, required — Curate params. Defines full curation pipeline, as an ordered dict of named curation steps. Order of steps *does* matter -- they are executed in the order defined.
      - `steps` object
    - `curate_document_store` DocumentStoreParams, required — Document store params.
      - `document_tags` object
    - `transform` TransformParams, required — Transform params. Defines full transform pipeline, as an ordered dict of named transform steps. Order of steps *does* matter -- they are executed in the order defined.
      - `steps` object
    - `vector_store` VectorStoreParams, required — Vector store params.
      - `weaviate_collection_name` string, required — The name of the Weaviate collection to use for storing documents. Must start with AgilityKB and be valid.
      - `node_tags` object
  - `name` string, required
  - `description` string, required

## Response `200`

Successful Response

- KnowledgeBaseWithConfig
  - `ingestion_pipeline_params` KnowledgeBasePipelineParamsOutput, required — Knowledge base pipeline params. Parameters defined on the knowledge-base level for a pipeline.
    - `curate` CurateParams, required — Curate params. Defines full curation pipeline, as an ordered dict of named curation steps. Order of steps *does* matter -- they are executed in the order defined.
      - `steps` object
    - `curate_document_store` DocumentStoreParams, required — Document store params.
      - `document_tags` object
    - `transform` TransformParams, required — Transform params. Defines full transform pipeline, as an ordered dict of named transform steps. Order of steps *does* matter -- they are executed in the order defined.
      - `steps` object
    - `vector_store` VectorStoreParams, required — Vector store params.
      - `weaviate_collection_name` string, required — The name of the Weaviate collection to use for storing documents. Must start with AgilityKB and be valid.
      - `node_tags` object
  - `name` string, required
  - `description` string, required
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time, nullable, required

## Other responses

- `422` — Validation Error

## Changes

- **2024-12-13** `a5e85dccbbe3` — 2 info
  - added `#/components/schemas/CharacterSplitterV0Params` to the `ingestion_pipeline_params/transform/steps/additionalProperties/` request property `anyOf` list
  - added `#/components/schemas/CharacterSplitterV0Params` to the `ingestion_pipeline_params/transform/steps/additionalProperties/` response property `anyOf` list for the response status `200`
- **2024-12-07** `043c2e8fdb79` — 4 info
  - added `#/components/schemas/MarkdownNodeExpanderParams` to the `ingestion_pipeline_params/transform/steps/additionalProperties/` request property `anyOf` list
  - the `model` request property default value changed from `gpt-4o` to `gpt-4o-mini`
  - added `#/components/schemas/MarkdownNodeExpanderParams` to the `ingestion_pipeline_params/transform/steps/additionalProperties/` response property `anyOf` list for the response status `200`
  - the `model` response's property default value changed from `gpt-4o` to `gpt-4o-mini` for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/cleanlab/apis/agility/changes/api/knowledge_bases/:knowledge_base_id/put.md)

---

[API](https://skmtc.dev/cleanlab/apis/agility.md) · [All operations](https://skmtc.dev/cleanlab/apis/agility/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cleanlab/agility/revisions/9e6009a931b6/schema)