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

# Get Dataset Filesystem



## OpenAPI

````yaml /api-reference/openapi.json get /api/datasets/{dataset_id}/filesystem
openapi: 3.1.0
info:
  title: Blindsight API
  version: 0.1.0
  description: >-
    The full Blindsight REST surface, generated from the running application.
    Replace the server host with your own deployment.


    For the Runtime Security integration surface (scan, proxy, tool calls) see
    the Runtime Security spec, which is hand written and carries worked
    examples.
servers:
  - url: https://api.your-blindsight.com
    description: Your Blindsight deployment
security: []
tags:
  - name: Authentication
  - name: Single sign-on
  - name: Social sign-in
  - name: SCIM provisioning
  - name: Projects
  - name: Datasets
  - name: Uploads and imports
  - name: Scans
  - name: Schedules
  - name: Healing
  - name: RAG corpora
  - name: Custom rules
  - name: Playground
  - name: Search and activity
  - name: Apps
  - name: Devices and agents
  - name: Discovery
  - name: DLP policy
  - name: DLP installation
  - name: Compliance
  - name: Audit trail
  - name: Reports
  - name: Export templates
  - name: Workspaces
  - name: Users
  - name: Invitations
  - name: API keys
  - name: Settings
  - name: Directory sync
  - name: Integrations
  - name: Pending actions
  - name: License
  - name: Onboarding
  - name: Support
  - name: Platform operations
  - name: Webhooks
paths:
  /api/datasets/{dataset_id}/filesystem:
    get:
      tags:
        - Datasets
      summary: Get Dataset Filesystem
      operationId: get_dataset_filesystem_api_datasets__dataset_id__filesystem_get
      parameters:
        - name: dataset_id
          in: path
          required: true
          schema:
            type: string
            title: Dataset Id
        - name: depth
          in: query
          required: false
          schema:
            type: integer
            maximum: 8
            minimum: 1
            default: 3
            title: Depth
        - name: max_entries
          in: query
          required: false
          schema:
            type: integer
            maximum: 5000
            minimum: 50
            default: 600
            title: Max Entries
        - name: max_files_per_dir
          in: query
          required: false
          schema:
            type: integer
            maximum: 50
            minimum: 0
            default: 6
            title: Max Files Per Dir
        - name: version_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Dataset view version ("active" default, "original", or explicit
              version id)
            title: Version Id
          description: >-
            Dataset view version ("active" default, "original", or explicit
            version id)
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetFilesystemResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    DatasetFilesystemResponse:
      properties:
        dataset_id:
          type: string
          title: Dataset Id
        dataset_name:
          type: string
          title: Dataset Name
        root_path:
          type: string
          title: Root Path
        source_kind:
          type: string
          enum:
            - dataset
            - import_staging
          title: Source Kind
          default: dataset
        source_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Label
        root:
          $ref: '#/components/schemas/FileTreeNode'
        total_files:
          type: integer
          title: Total Files
        total_directories:
          type: integer
          title: Total Directories
        total_bytes:
          type: integer
          title: Total Bytes
        extension_counts:
          additionalProperties:
            type: integer
          type: object
          title: Extension Counts
        max_depth:
          type: integer
          title: Max Depth
        max_entries:
          type: integer
          title: Max Entries
        max_files_per_dir:
          type: integer
          title: Max Files Per Dir
        truncated:
          type: boolean
          title: Truncated
          default: false
      type: object
      required:
        - dataset_id
        - dataset_name
        - root_path
        - root
        - total_files
        - total_directories
        - total_bytes
        - max_depth
        - max_entries
        - max_files_per_dir
      title: DatasetFilesystemResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FileTreeNode:
      properties:
        name:
          type: string
          title: Name
        path:
          type: string
          title: Path
        depth:
          type: integer
          title: Depth
        file_count:
          type: integer
          title: File Count
          default: 0
        total_bytes:
          type: integer
          title: Total Bytes
          default: 0
        has_children:
          type: boolean
          title: Has Children
          default: false
        sample_files:
          items:
            $ref: '#/components/schemas/FileSample'
          type: array
          title: Sample Files
        children:
          items:
            $ref: '#/components/schemas/FileTreeNode'
          type: array
          title: Children
      type: object
      required:
        - name
        - path
        - depth
      title: FileTreeNode
    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
    FileSample:
      properties:
        name:
          type: string
          title: Name
        size_bytes:
          anyOf:
            - type: integer
            - type: 'null'
          title: Size Bytes
        extension:
          anyOf:
            - type: string
            - type: 'null'
          title: Extension
        path:
          anyOf:
            - type: string
            - type: 'null'
          title: Path
      type: object
      required:
        - name
      title: FileSample

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.