> ## 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 File Preview



## OpenAPI

````yaml /api-reference/openapi.json get /api/datasets/{dataset_id}/filesystem/preview
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/preview:
    get:
      tags:
        - Datasets
      summary: Get Dataset File Preview
      operationId: >-
        get_dataset_file_preview_api_datasets__dataset_id__filesystem_preview_get
      parameters:
        - name: dataset_id
          in: path
          required: true
          schema:
            type: string
            title: Dataset Id
        - name: path
          in: query
          required: true
          schema:
            type: string
            description: Relative path to the file within the dataset
            title: Path
          description: Relative path to the file within the dataset
        - 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/DatasetFilePreview'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    DatasetFilePreview:
      properties:
        name:
          type: string
          title: Name
        path:
          type: string
          title: Path
        size_bytes:
          anyOf:
            - type: integer
            - type: 'null'
          title: Size Bytes
        extension:
          anyOf:
            - type: string
            - type: 'null'
          title: Extension
        mime_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Mime Type
        kind:
          type: string
          enum:
            - image
            - text
            - binary
          title: Kind
        preview_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Preview Text
        truncated:
          type: boolean
          title: Truncated
          default: false
        preview_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Preview Url
      type: object
      required:
        - name
        - path
        - kind
      title: DatasetFilePreview
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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

````

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