> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hill90.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shared knowledge quality stats

> Returns aggregate quality and operations metrics for shared knowledge. Response contains only counts, rates, averages, and status distributions. No raw query text, no requester identifiers, no cross-user query logs.




## OpenAPI

````yaml /openapi.yaml get /shared-knowledge/stats
openapi: 3.0.3
info:
  title: Hill90 API
  description: Hill90 platform API — agent management and lifecycle operations.
  version: 0.1.0
servers:
  - url: /
    description: Relative (behind Traefik reverse proxy)
security: []
paths:
  /shared-knowledge/stats:
    get:
      summary: Shared knowledge quality stats
      description: >
        Returns aggregate quality and operations metrics for shared knowledge.
        Response contains only counts, rates, averages, and status
        distributions. No raw query text, no requester identifiers, no
        cross-user query logs.
      parameters:
        - name: since
          in: query
          schema:
            type: string
            format: date-time
          description: ISO timestamp to scope time-based stats (search, ingest)
      responses:
        '200':
          description: Aggregate stats
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedKnowledgeStats'
        '401':
          description: Not authenticated
        '403':
          description: Requires user role
      security:
        - bearerAuth: []
components:
  schemas:
    SharedKnowledgeStats:
      type: object
      description: >-
        Aggregate-only quality and operations metrics. No raw query text, no
        requester identifiers.
      properties:
        search:
          type: object
          properties:
            total:
              type: integer
            zero_result_count:
              type: integer
            zero_result_rate:
              type: number
            avg_duration_ms:
              type: integer
              nullable: true
            by_requester_type:
              type: array
              items:
                type: object
                properties:
                  requester_type:
                    type: string
                  total:
                    type: integer
                  zero_result_count:
                    type: integer
                  zero_result_rate:
                    type: number
        ingest:
          type: object
          properties:
            total_jobs:
              type: integer
            completed:
              type: integer
            failed:
              type: integer
            running:
              type: integer
            pending:
              type: integer
            error_rate:
              type: number
            avg_processing_ms:
              type: integer
              nullable: true
        sources:
          type: object
          properties:
            by_status:
              type: object
              additionalProperties:
                type: integer
            by_type:
              type: object
              additionalProperties:
                type: integer
        corpus:
          type: object
          properties:
            total_collections:
              type: integer
            total_sources:
              type: integer
            total_chunks:
              type: integer
            total_tokens:
              type: integer
        usage:
          type: object
          properties:
            top_collections:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  name:
                    type: string
                  retrieval_count:
                    type: integer
            top_sources:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  title:
                    type: string
                  collection_name:
                    type: string
                  retrieval_count:
                    type: integer
        since:
          type: string
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````