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

# Agent Scan



## OpenAPI

````yaml /api-reference/openapi.json post /api/runtime-security/agent/scan
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/agent/scan:
    post:
      tags:
        - runtime-security-agent
      summary: Agent Scan
      operationId: agent_scan_api_runtime_security_agent_scan_post
      parameters:
        - name: X-Blindsight-Device-Token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-Device-Token
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentScanRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentScanResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AgentScanRequest:
      properties:
        direction:
          type: string
          pattern: ^(input|output)$
          title: Direction
          default: input
        text:
          type: string
          title: Text
          default: ''
        scan_status:
          anyOf:
            - type: string
              maxLength: 32
            - type: 'null'
          title: Scan Status
        host:
          anyOf:
            - type: string
              maxLength: 255
            - type: 'null'
          title: Host
          description: AI destination host the agent intercepted.
        provider:
          anyOf:
            - type: string
              maxLength: 32
            - type: 'null'
          title: Provider
        model:
          anyOf:
            - type: string
              maxLength: 128
            - type: 'null'
          title: Model
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
      type: object
      title: AgentScanRequest
    AgentScanResponse:
      properties:
        uuid:
          type: string
          title: Uuid
        verdict:
          type: string
          title: Verdict
        redacted_text:
          type: string
          title: Redacted Text
        blocked_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Blocked Reason
        fail_mode:
          type: string
          title: Fail Mode
      type: object
      required:
        - uuid
        - verdict
        - redacted_text
        - fail_mode
      title: AgentScanResponse
    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

````