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

# Create Knowledge Base

> Create Knowledge Base.

### Authorizations

<ParamField header="X-Api-Key" type="string" required>
  Your Agni API key used to authenticate the request. Pass it in the `X-Api-Key` header. Find or rotate it from your Ravan AI account settings.
</ParamField>

***

### Body

<ParamField body="knowledge_base_name" type="string" required>
  The display name for the knowledge base. Use a clear name that describes the source content.
</ParamField>

<ParamField body="enable_auto_refresh" type="boolean">
  Whether the knowledge base should automatically refresh supported sources after creation.
</ParamField>

***

### Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded.
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable status message.
</ResponseField>

<ResponseField name="data" type="object">
  Returned data.

  <Expandable title="data">
    <ResponseField name="knowledge_base_id" type="string">
      Knowledge base UUID
    </ResponseField>

    <ResponseField name="knowledge_base_name" type="string">
      Knowledge base name
    </ResponseField>

    <ResponseField name="status" type="string">
      Status: `complete`, `in_progress`, or `error`
    </ResponseField>

    <ResponseField name="enable_auto_refresh" type="boolean">
      Whether auto-refresh is enabled
    </ResponseField>

    <ResponseField name="knowledge_base_sources" type="array">
      Array of sources (empty on creation)
    </ResponseField>

    <ResponseField name="created_timestamp" type="integer">
      Creation timestamp (Unix ms)
    </ResponseField>

    <ResponseField name="last_updated_timestamp" type="integer">
      Last updated timestamp (Unix ms)
    </ResponseField>
  </Expandable>
</ResponseField>


## OpenAPI

````yaml POST /api/v1/rag/create-knowledge-base
openapi: 3.0.1
info:
  title: Agni API
  version: 1.0.0
  description: >-
    Agni API for managing agents, tools, widget settings, telephony, and
    integrations.
servers:
  - url: https://api.ravan.ai
security:
  - X-Api-Key: []
tags:
  - name: AgentService
  - name: AgentToolService
  - name: WidgetSettingsService
  - name: PhoneService
  - name: AppointmentService
  - name: GHLService
  - name: CalComService
  - name: CampaignService
  - name: ContactService
  - name: CallingService
  - name: RAGService
  - name: ModelService
  - name: HealthService
paths:
  /api/v1/rag/create-knowledge-base:
    post:
      tags:
        - RAGService
      summary: Create Knowledge Base
      operationId: CreateKnowledgeBase
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateKnowledgeBaseRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeBaseResponse'
components:
  schemas:
    CreateKnowledgeBaseRequest:
      type: object
      required:
        - knowledge_base_name
      properties:
        knowledge_base_name:
          type: string
          description: Name for the knowledge base
        enable_auto_refresh:
          type: boolean
          description: Enable automatic refresh of sources
    KnowledgeBaseResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          $ref: '#/components/schemas/KnowledgeBaseDetail'
    KnowledgeBaseDetail:
      type: object
      properties:
        knowledge_base_id:
          type: string
          description: Knowledge base UUID
        knowledge_base_name:
          type: string
          description: Knowledge base name
        status:
          type: string
          description: 'Status: complete, in_progress, or error'
        enable_auto_refresh:
          type: boolean
          description: Whether auto-refresh is enabled
        knowledge_base_sources:
          type: array
          items:
            $ref: '#/components/schemas/KnowledgeBaseSource'
        created_timestamp:
          type: integer
          description: Creation timestamp (Unix ms)
        last_updated_timestamp:
          type: integer
          description: Last updated timestamp (Unix ms)
    KnowledgeBaseSource:
      type: object
      properties:
        source_id:
          type: string
          description: Source UUID
        source_type:
          type: string
          description: 'Type: text, url, or document'
        source_name:
          type: string
          description: Source name or title
        source_url:
          type: string
          description: Source URL (for url type)
        source_status:
          type: string
          description: 'Status: complete, indexing, or error'
        created_timestamp:
          type: integer
          description: Creation timestamp (Unix ms)
  securitySchemes:
    X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key

````