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

# Get files connector

> Returns the files connector row (auto-created if missing), including all folder structure rows and file knowledge_source rows underneath. The connector is a singleton per installation.



## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api get /knowledgeSource/filesConnector
openapi: 3.0.0
info:
  version: '1'
  title: enneo.MIND API
  description: This describes the API of enneo Mind, the main ticketing backend
  contact:
    name: enneo GmbH
    email: richard@enneo.ai
  license:
    name: Proprietary software
    url: https://enneo.ai
servers:
  - url: https://demo.enneo.ai/api/mind
    description: Production server, demo client
  - url: https://main.enneo.dev/api/mind
    description: Development main branch
  - url: http://localhost:8005/api/mind
    description: Local development server
security:
  - bearerAuth:
      - api
  - cookieAuth:
      - api
paths:
  /knowledgeSource/filesConnector:
    get:
      tags:
        - Files connector
      summary: Get files connector
      description: >-
        Returns the files connector row (auto-created if missing), including all
        folder structure rows and file knowledge_source rows underneath. The
        connector is a singleton per installation.
      operationId: getFilesConnector
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilesConnector'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    FilesConnector:
      type: object
      description: >-
        Files connector root object. Manages drag-and-drop document upload into
        the Knowledge Base.
      properties:
        id:
          type: integer
          description: Connector structure ID
          example: 10
        name:
          type: string
          description: Always "Files"
          example: Files
        type:
          type: string
          description: Always "file"
          example: file
        folderCount:
          type: integer
          description: Number of folders under this connector
          example: 5
        fileCount:
          type: integer
          description: Number of active file articles under this connector
          example: 23
        data:
          type: object
          properties:
            allowedExtensions:
              type: array
              items:
                type: string
              example:
                - pdf
                - docx
                - txt
            maxFileSizeMb:
              type: integer
              example: 50
        folders:
          type: array
          items:
            $ref: '#/components/schemas/FilesConnectorFolder'
        files:
          type: array
          items:
            $ref: '#/components/schemas/FilesConnectorFile'
    Error:
      type: object
      description: Data format of Enneo error messages
      properties:
        error:
          type: string
          example: Contract 121 could not be processed
          description: Readable error message that should be shown to the user
        details:
          type: string
          example: >-
            Uncatched null point exception in testFunction() in
            /app/src/file:212
          description: Not easily readable error message that is for the developer
        txId:
          type: string
          example: c916167c94
          description: >-
            Internal transaction id. Useful for debugging. Corresponds to the
            OpenTelemetry trace ID.
    FilesConnectorFolder:
      type: object
      properties:
        id:
          type: integer
          example: 11
        parent:
          type: integer
          description: Parent structure ID (connector ID if top-level)
          example: 10
        name:
          type: string
          example: Sales
    FilesConnectorFile:
      type: object
      properties:
        id:
          type: integer
          example: 42
        parent:
          type: integer
          description: Parent structure ID (folder or connector)
          example: 11
        name:
          type: string
          description: Bare filename (display name)
          example: Pricing-2026.pdf
        title:
          type: string
          description: Same as name for file articles
          example: Pricing-2026.pdf
        source:
          type: string
          description: Full path-qualified label, e.g. "Sales/Pricing-2026.pdf"
          example: Sales/Pricing-2026.pdf
        status:
          type: string
          enum:
            - active
            - archived
            - deleted
          example: active
        originalFileName:
          type: string
          description: Preserved original uploaded filename (stable across renames)
          example: Pricing-2026.pdf
        originalMimeType:
          type: string
          example: application/pdf
        originalSize:
          type: integer
          description: Original file size in bytes
          example: 2154288
        originalUrl:
          type: string
          description: Internal URL to the stored binary
          example: /api/mind/storage/knowledgeSources/42-abc12345/Pricing-2026.pdf
        hasManualMarkdownEdits:
          type: boolean
          description: >
            True when the generated Markdown in `text` has been manually edited
            via

            `PATCH /knowledgeSource/{id}`. Reset to `false` on initial upload,
            replace, and re-index.

            Consumed by the FE to warn users before a re-upload would overwrite
            their edits.
          default: false
          example: false
        createdAt:
          type: string
          format: date-time
        modifiedAt:
          type: string
          format: date-time
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT-based authentication
      x-scopes:
        api: Full access to the API
    cookieAuth:
      type: apiKey
      in: cookie
      name: connect.sid
      description: Cookie-based authentication
      x-scopes:
        api: Full access to the API

````