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

# Link App Dataset



## OpenAPI

````yaml /api-reference/openapi.json post /api/runtime-security/apps/{app_uuid}/dataset/link
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: []
paths:
  /api/runtime-security/apps/{app_uuid}/dataset/link:
    post:
      tags:
        - runtime-security-apps
      summary: Link App Dataset
      operationId: link_app_dataset_api_runtime_security_apps__app_uuid__dataset_link_post
      parameters:
        - name: app_uuid
          in: path
          required: true
          schema:
            type: string
            title: App Uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppDatasetLink'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppDatasetSummary'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AppDatasetLink:
      properties:
        dataset_uuid:
          type: string
          minLength: 1
          title: Dataset Uuid
          description: UUID of the existing dataset to link to this App.
      type: object
      required:
        - dataset_uuid
      title: AppDatasetLink
    AppDatasetSummary:
      properties:
        app_id:
          type: string
          title: App Id
        field_picks:
          items:
            type: string
          type: array
          title: Field Picks
        privacy_mode:
          type: string
          enum:
            - redacted_only
            - both_role_gated
            - hashed_pii
            - user_choice
          title: Privacy Mode
        batch_interval_seconds:
          type: integer
          title: Batch Interval Seconds
        event_count:
          type: integer
          title: Event Count
        last_event_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Event At
        materialised_dataset_uuid:
          anyOf:
            - type: string
            - type: 'null'
          title: Materialised Dataset Uuid
          description: >-
            UUID of the Data Security Dataset materialised from this App's
            events, if one exists. Convention: dataset.meta carries
            'source_runtime_security_app_uuid' set to the App's uuid.
      type: object
      required:
        - app_id
        - field_picks
        - privacy_mode
        - batch_interval_seconds
        - event_count
      title: AppDatasetSummary
    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

````