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

# Search shared knowledge

> Full-text search across shared knowledge chunks. Results include provenance (source, document, collection metadata) and relevance scores. Scoped to user's visible collections.




## OpenAPI

````yaml /openapi.yaml get /shared-knowledge/search
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/search:
    get:
      summary: Search shared knowledge
      description: >
        Full-text search across shared knowledge chunks. Results include
        provenance (source, document, collection metadata) and relevance scores.
        Scoped to user's visible collections.
      parameters:
        - name: q
          in: query
          required: true
          schema:
            type: string
            minLength: 1
          description: Search query
        - name: collection_id
          in: query
          schema:
            type: string
            format: uuid
          description: Optional collection filter
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          description: Max results
      responses:
        '200':
          description: Search results with provenance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedSearchResult'
        '400':
          description: Missing q parameter
        '401':
          description: Not authenticated
        '403':
          description: Requires user role
      security:
        - bearerAuth: []
components:
  schemas:
    SharedSearchResult:
      type: object
      properties:
        query:
          type: string
        results:
          type: array
          items:
            type: object
            properties:
              chunk_id:
                type: string
                format: uuid
              content:
                type: string
              chunk_index:
                type: integer
              score:
                type: number
              headline:
                type: string
              source_id:
                type: string
                format: uuid
              source_title:
                type: string
              source_url:
                type: string
                nullable: true
              document_id:
                type: string
                format: uuid
              document_title:
                type: string
              collection_id:
                type: string
                format: uuid
              collection_name:
                type: string
              quality_score:
                type: number
                description: Normalized quality score (0–1)
              quality_label:
                type: string
                enum:
                  - high
                  - medium
                  - low
                description: Quality classification
        count:
          type: integer
        search_type:
          type: string
          example: fts
        score_type:
          type: string
          example: ts_rank
        quality_summary:
          type: object
          properties:
            avg_score:
              type: number
            min_score:
              type: number
            max_score:
              type: number
            distribution:
              type: object
              properties:
                high:
                  type: integer
                medium:
                  type: integer
                low:
                  type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````