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

# Create App Event Scan



## OpenAPI

````yaml /api-reference/openapi.json post /api/runtime-security/apps/{app_uuid}/scans
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}/scans:
    post:
      tags:
        - runtime-security-apps
      summary: Create App Event Scan
      operationId: create_app_event_scan_api_runtime_security_apps__app_uuid__scans_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/EventScanCreate'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventScanRead'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    EventScanCreate:
      properties:
        engines:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Engines
          description: Engine keys to run. Omit/empty for the default set.
        window_days:
          type: integer
          maximum: 90
          minimum: 1
          title: Window Days
          default: 7
        event_source_filter:
          anyOf:
            - type: string
              enum:
                - live
                - uploaded
            - type: 'null'
          title: Event Source Filter
          description: Restrict the scan to live or uploaded events only.
        enable_concept_labelling:
          type: boolean
          title: Enable Concept Labelling
          description: >-
            Bias/shortcut: run concept-level labelling (rule-based, no external
            cost).
          default: true
        enable_live_probing:
          type: boolean
          title: Enable Live Probing
          description: 'Bias/shortcut: counterfactual re-scans through the live firewall.'
          default: false
        baseline_days:
          type: integer
          maximum: 365
          minimum: 1
          title: Baseline Days
          description: Drift baseline window.
          default: 30
      type: object
      title: EventScanCreate
    EventScanRead:
      properties:
        id:
          type: string
          title: Id
        status:
          type: string
          enum:
            - pending
            - running
            - complete
            - failed
            - cancelled
          title: Status
        trigger_mode:
          type: string
          enum:
            - manual
            - auto_ingest
            - scheduled
            - on_upload
          title: Trigger Mode
        engines:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Engines
        window_days:
          type: integer
          title: Window Days
        event_source_filter:
          anyOf:
            - type: string
            - type: 'null'
          title: Event Source Filter
        upload_batch_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Upload Batch Id
        events_scanned:
          type: integer
          title: Events Scanned
        findings_count:
          type: integer
          title: Findings Count
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
        summary:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Summary
        created_at:
          type: string
          format: date-time
          title: Created At
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
      type: object
      required:
        - id
        - status
        - trigger_mode
        - window_days
        - events_scanned
        - findings_count
        - created_at
      title: EventScanRead
    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

````