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

# NER PII tier load state (GLiNER2-PII model, readiness, defaults)

> Also warms the model: the first call from the UI or your own
tooling kicks off the background load (~40s cold) so the tier
is ready by the time traffic needs it. Requires
`runtime_security.view`.




## OpenAPI

````yaml /api-reference/openapi-runtime-security.yaml get /api/runtime-security/ner/status
openapi: 3.1.0
info:
  title: Blindsight Runtime Security API
  version: 1.0.0
  summary: LLM firewall — prompt-injection, PII, and agent tool-call protection.
  description: |
    Drop-in firewall for LLM traffic. Three integration modes:

      * **Scan API** — explicit `/scan/input` and `/scan/output` calls.
      * **Reverse proxy** — wire-compatible with the OpenAI and Anthropic
        SDKs; swap the SDK's `base_url` to enable scanning at the network
        boundary.
      * **Tool-call scan** — sub-millisecond regex check on agent tool
        arguments before execution.

    See `runtime-security-guide.md` for prose docs, SDK examples, and a
    walk-through of verdicts and configuration.
  contact:
    name: Blindsight Support
    url: https://blindsight.example.com/support
  license:
    name: Proprietary
servers:
  - url: https://api.blindsight.example.com
    description: Production
  - url: https://api.staging.blindsight.example.com
    description: Staging
security:
  - ApiKeyAuth: []
  - BlindsightKeyAuth: []
  - SessionCookieAuth: []
tags:
  - name: Scan
    description: Single-call scan endpoints for input, output, batch, and tool calls.
  - name: Proxy
    description: Wire-compatible reverse-proxy endpoints for OpenAI and Anthropic.
  - name: Configuration
    description: Workspace-scoped firewall settings.
  - name: Analytics
    description: Read-only analytics, event log, and drift dashboard endpoints.
  - name: Health
    description: Liveness and ECS service status.
paths:
  /api/runtime-security/ner/status:
    get:
      tags:
        - Health
      summary: NER PII tier load state (GLiNER2-PII model, readiness, defaults)
      description: |
        Also warms the model: the first call from the UI or your own
        tooling kicks off the background load (~40s cold) so the tier
        is ready by the time traffic needs it. Requires
        `runtime_security.view`.
      operationId: getNerStatus
      responses:
        '200':
          description: NER tier status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NerStatus'
components:
  schemas:
    NerStatus:
      type: object
      properties:
        enabled:
          type: boolean
        available:
          type: boolean
          description: >-
            True when the `gliner2` package (and torch) are importable in this
            image.
        state:
          type: string
          enum:
            - idle
            - loading
            - ready
            - error
            - disabled
            - unavailable
        model:
          type: string
        load_seconds:
          type: number
          nullable: true
        error:
          type: string
          nullable: true
        default_entities:
          type: array
          items:
            type: string
        default_threshold:
          type: number
        default_mode:
          type: string
          enum:
            - flag
            - redact
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |
        Blindsight workspace API key (`ak_live_…`). Use this header for the
        scan API and the OpenAI proxy routes. The required permission
        scope is `runtime_security.scan` for scan endpoints,
        `runtime_security.view` for read-only analytics, and
        `runtime_security.manage` for configuration changes.
    BlindsightKeyAuth:
      type: apiKey
      in: header
      name: X-Blindsight-Key
      description: |
        Alternative header for Anthropic proxy callers — `x-api-key` is
        reserved for the upstream provider on those routes. Accepts an
        Blindsight API key or `Bearer <jwt>`.
    SessionCookieAuth:
      type: apiKey
      in: cookie
      name: blindsight_session
      description: In-app dashboard session — for browser callers only.

````