> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verbex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Knowledge Base

> Updates the configuration and metadata of an existing knowledge base. This allows you to modify 
properties such as the name, description, or any custom settings associated with the knowledge base
while preserving its documents and relationships.



## OpenAPI

````yaml /api-reference/openapi.json put /v2/knowledge-bases/{kb_id}
openapi: 3.1.0
info:
  title: Verbex Platform API
  description: API for managing AI agents, calls, phone numbers, and more.
  version: 1.0.0
servers: []
security: []
paths:
  /v2/knowledge-bases/{kb_id}:
    put:
      tags:
        - Knowledge Bases v2
      summary: Update Knowledge Base
      description: >-
        Updates the configuration and metadata of an existing knowledge base.
        This allows you to modify 

        properties such as the name, description, or any custom settings
        associated with the knowledge base

        while preserving its documents and relationships.
      operationId: update_knowledge_base_v2_knowledge_bases__kb_id__put
      parameters:
        - name: kb_id
          in: path
          required: true
          schema:
            type: string
            title: Kb Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/app__knowledge_bases_v2__schemas__UpdateKnowledgeBaseRequest
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/app__knowledge_bases_v2__schemas__KnowledgeBaseResponse
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    app__knowledge_bases_v2__schemas__UpdateKnowledgeBaseRequest:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: >-
            New name for the knowledge base. Leave empty to keep the existing
            name.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: >-
            New description for the knowledge base. Leave empty to keep the
            existing description.
        document_language:
          anyOf:
            - type: string
            - type: 'null'
          title: Document Language
          description: >-
            New language for the documents in the knowledge base. Leave empty to
            keep the existing language.
      type: object
      title: UpdateKnowledgeBaseRequest
      description: Data Transfer Object for updating an existing Knowledge Base.
    app__knowledge_bases_v2__schemas__KnowledgeBaseResponse:
      properties:
        _id:
          type: string
          title: Id
          description: Unique identifier of the knowledge base in MongoDB ObjectId format.
        name:
          type: string
          title: Name
          description: The name of the knowledge base.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Detailed description of the knowledge base's purpose and contents.
        document_language:
          type: string
          title: Document Language
          description: >-
            The language of the documents in the knowledge base. This will be
            used to filter documents by language when adding to the knowledge
            base.
          default: en
        document_count:
          type: integer
          title: Document Count
          description: Total number of documents currently stored in this knowledge base.
          default: 0
        created_at:
          type: string
          format: date-time
          title: Created At
          description: UTC timestamp indicating when this knowledge base was created.
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: UTC timestamp indicating when this knowledge base was last modified.
        status:
          anyOf:
            - type: string
              enum:
                - processing
                - completed
                - failed
            - type: 'null'
          title: Status
          description: >-
            Status of the knowledge base. 'processing' means documents are being
            processed. 'completed' means all documents are processed and ready.
            'failed' means there was an error in processing the documents.
      type: object
      required:
        - _id
        - name
        - created_at
        - updated_at
      title: KnowledgeBaseResponse
      description: Response model for a Knowledge Base.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````