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

# Create a new folder

> Create a new knowledge base folder to organize documents.



## OpenAPI

````yaml /openapi.json post /api/documents/assistant/folders
openapi: 3.0.0
info:
  title: Vambe AI API
  description: Vambe AI documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://api.vambe.me
    description: Production Server
security: []
tags:
  - name: Vambe AI
    description: ''
paths:
  /api/documents/assistant/folders:
    post:
      tags:
        - Assistant Documents
      summary: Create a new folder
      description: Create a new knowledge base folder to organize documents.
      operationId: PublicRagieController_createFolder
      parameters:
        - name: x-api-key
          in: header
          description: API key needed to authorize the request
          required: true
          schema:
            type: string
      requestBody:
        required: true
        description: Folder details
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Folder name
                  example: Product Documentation
                icon:
                  type: string
                  description: Optional icon/emoji for the folder
                  example: 📚
                sort_order:
                  type: number
                  description: 'Optional sort order (default: 0)'
                  example: 0
                parent_folder_id:
                  type: string
                  description: Optional parent folder ID for nested folders
                  example: null
              required:
                - name
      responses:
        '201':
          description: Folder created successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: 550e8400-e29b-41d4-a716-446655440000
                  name:
                    type: string
                    example: Product Documentation
                  icon:
                    type: string
                    example: 📚
                  sort_order:
                    type: number
                    example: 0
                  client_id:
                    type: string
                  created_at:
                    type: string
                    example: '2024-01-15T10:00:00.000Z'
        '400':
          description: Bad request.
        '401':
          description: Unauthorized.

````