> ## 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.

# Import From Huggingface



## OpenAPI

````yaml /api-reference/openapi.json post /api/import/huggingface
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/import/huggingface:
    post:
      tags:
        - Uploads and imports
      summary: Import From Huggingface
      operationId: import_from_huggingface_api_import_huggingface_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HuggingFaceImportRequest'
        required: true
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobAcceptedResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HuggingFaceImportRequest:
      properties:
        dataset_id:
          type: string
          title: Dataset Id
          description: Hugging Face dataset ID (owner/name)
        token:
          anyOf:
            - type: string
              maxLength: 256
            - type: 'null'
          title: Token
          description: Optional Hugging Face read token for gated datasets.
        use_saved_credentials:
          type: boolean
          title: Use Saved Credentials
          description: >-
            If false, skip saved per-user/global credentials and only use inline
            values.
          default: true
        image_specificity:
          type: string
          enum:
            - fine
            - broad
          title: Image Specificity
          description: Fine for medical imaging specificity, broad for general imaging.
          default: fine
        convert_tables:
          type: boolean
          title: Convert Tables
          description: Convert Parquet/Arrow table datasets into raw files when needed.
          default: true
        project_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Project Id
          description: Optional project UUID to attach the imported dataset to.
        dataset_name:
          anyOf:
            - type: string
              maxLength: 120
            - type: 'null'
          title: Dataset Name
          description: Optional display name for the dataset folder.
        branch_name:
          anyOf:
            - type: string
              maxLength: 255
            - type: 'null'
          title: Branch Name
          description: Optional initial branch name for the created dataset.
        target_dataset_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Target Dataset Id
          description: >-
            Optional existing dataset UUID to append/replace data instead of
            creating a new dataset.
        mode:
          type: string
          enum:
            - append
            - replace
          title: Mode
          description: >-
            When target_dataset_id is provided, either append into existing data
            or replace it.
          default: replace
      type: object
      required:
        - dataset_id
      title: HuggingFaceImportRequest
    JobAcceptedResponse:
      properties:
        job_id:
          type: string
          title: Job Id
        status:
          type: string
          title: Status
        dataset_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Dataset Id
      type: object
      required:
        - job_id
        - status
      title: JobAcceptedResponse
    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.