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

# List and Create Knowledge Bases

> List or create organization-level RAG knowledge bases

## Path Parameters

<ParamField path="organization_id" type="string" required>
  Organization ID (UUID).
</ParamField>

## List Knowledge Bases

Returns all knowledge bases in the organization with a `source_count` for each.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.telzino.com/v1/organizations/987fcdeb-51a2-3bc4-d567-890123456789/knowledge-bases \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "11111111-1111-1111-1111-111111111111",
        "organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
        "name": "Support Docs",
        "description": null,
        "source_count": 3,
        "created_at": "2026-06-17T12:00:00Z",
        "updated_at": "2026-06-17T12:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>

## Create a Knowledge Base

Send a JSON body to the same endpoint.

<ParamField body="name" type="string" required>
  Knowledge base name, 1-255 characters. Names must be unique within the organization.
</ParamField>

<ParamField body="description" type="string | null">
  Optional description, up to 2000 characters.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.telzino.com/v1/organizations/987fcdeb-51a2-3bc4-d567-890123456789/knowledge-bases \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Support Docs",
      "description": "FAQs and product documentation"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "id": "11111111-1111-1111-1111-111111111111",
      "organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
      "name": "Support Docs",
      "description": "FAQs and product documentation",
      "source_count": 0,
      "created_at": "2026-06-17T12:00:00Z",
      "updated_at": "2026-06-17T12:00:00Z"
    }
  }
  ```

  ```json 403 theme={null}
  {
    "error": "forbidden",
    "error_description": "RAG feature is not enabled for this organization"
  }
  ```

  ```json 409 theme={null}
  {
    "error": "conflict",
    "error_description": "A knowledge base with that name already exists"
  }
  ```
</ResponseExample>