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

# Scan Tool Call Endpoint



## OpenAPI

````yaml /api-reference/openapi.json post /api/runtime-security/scan/tool-call
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/scan/tool-call:
    post:
      tags:
        - runtime-security
      summary: Scan Tool Call Endpoint
      operationId: scan_tool_call_endpoint_api_runtime_security_scan_tool_call_post
      parameters:
        - name: X-Blindsight-App-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-App-Id
        - name: X-Blindsight-App-Token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-App-Token
        - name: X-Blindsight-Component-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-Component-Id
        - name: X-Blindsight-Workload-Platform
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-Workload-Platform
        - name: X-Blindsight-Activity-Type
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-Activity-Type
        - 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/ScanToolCallRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScanToolCallResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ScanToolCallRequest:
      properties:
        tool_name:
          type: string
          maxLength: 200
          title: Tool Name
        arguments:
          title: Arguments
          description: Tool arguments, dict/list/string/number.
        source_app:
          anyOf:
            - type: string
              maxLength: 128
            - type: 'null'
          title: Source App
        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
      required:
        - tool_name
      title: ScanToolCallRequest
    ScanToolCallResponse:
      properties:
        uuid:
          type: string
          title: Uuid
        verdict:
          type: string
          title: Verdict
        reasons:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Reasons
        redacted_arguments:
          title: Redacted Arguments
        pii:
          additionalProperties: true
          type: object
          title: Pii
        arg_bytes:
          type: integer
          title: Arg Bytes
        blocked_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Blocked Reason
        latency_ms:
          type: integer
          title: Latency Ms
      type: object
      required:
        - uuid
        - verdict
        - reasons
        - redacted_arguments
        - pii
        - arg_bytes
        - latency_ms
      title: ScanToolCallResponse
    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

````