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

# Upload Text Dataset



## OpenAPI

````yaml /api-reference/openapi.json post /api/uploads/dataset/text
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/uploads/dataset/text:
    post:
      tags:
        - Uploads and imports
      summary: Upload Text Dataset
      operationId: upload_text_dataset_api_uploads_dataset_text_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TextDatasetUploadRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    TextDatasetUploadRequest:
      properties:
        dataset_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Dataset Name
        branch_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Branch Name
        s3_url:
          anyOf:
            - type: string
            - type: 'null'
          title: S3 Url
        documents:
          items:
            $ref: '#/components/schemas/TextDocumentInput'
          type: array
          title: Documents
        off_topic_collective:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Off Topic Collective
        webhook_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Webhook Url
        webhook_on_complete:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Webhook On Complete
        webhook_on_failure:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Webhook On Failure
        repo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Repo Url
        repo_access_token:
          anyOf:
            - type: string
            - type: 'null'
          title: Repo Access Token
        use_saved_credentials:
          type: boolean
          title: Use Saved Credentials
          default: true
      type: object
      title: TextDatasetUploadRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TextDocumentInput:
      properties:
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
        content_base64:
          anyOf:
            - type: string
            - type: 'null'
          title: Content Base64
        mime_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Mime Type
      type: object
      title: TextDocumentInput
    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.