---
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, 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-11-01** `36e7c2cdfead` — 1 breaking, 5 info
  - added `#/components/schemas/RemoveEmbeddedImagesParams` to the `ingestion_pipeline_params/curate/steps/additionalProperties/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SemanticMergeSplitterV0Params, #/components/schemas/NodeSummarizerV0Params` to the `ingestion_pipeline_params/transform/steps/additionalProperties/` request property `anyOf` list
  - added `remove_embedded_images.v0` discriminator mapping keys to the `ingestion_pipeline_params/curate/steps/additionalProperties/` request property
  - added `#/components/schemas/RemoveEmbeddedImagesParams` to the `ingestion_pipeline_params/curate/steps/additionalProperties/` request property `oneOf` list
  - …2 more

[Change 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/36e7c2cdfead/schema)