> ## 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 Direct Url



## OpenAPI

````yaml /api-reference/openapi.json post /api/import/direct
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/direct:
    post:
      tags:
        - Uploads and imports
      summary: Import From Direct Url
      operationId: import_from_direct_url_api_import_direct_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectImportRequest'
        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:
    DirectImportRequest:
      properties:
        url:
          type: string
          title: Url
          description: Direct archive URL (.zip/.tar/.tar.gz/.tgz)
        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:
        - url
      title: DirectImportRequest
    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.