openapi: 3.1.0
info:
  title: Kyverno Policy Reporter ClusterPolicyReports Namespaces API
  description: The Kyverno Policy Reporter REST API provides endpoints for querying PolicyReport and ClusterPolicyReport custom resources generated by Kyverno. It exposes policy results, status counts, and resource-level violation data, serving as the backend for the Policy Reporter UI. The API enables programmatic access to policy compliance status across namespaces and clusters.
  version: 2.0.0
  contact:
    name: Kyverno Community
    url: https://kyverno.io/community/
  termsOfService: https://kyverno.io/
servers:
- url: http://localhost:8080
  description: Default Policy Reporter server
tags:
- name: Namespaces
  description: Namespace listing endpoints
paths:
  /api/v1/namespaces:
    get:
      operationId: listNamespaces
      summary: Kyverno List namespaces with policy reports
      description: Returns a list of namespace names that have associated PolicyReport resources. Useful for filtering result queries by namespace.
      tags:
      - Namespaces
      responses:
        '200':
          description: List of namespace names
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
                  example: default
externalDocs:
  description: Policy Reporter API Reference
  url: https://kyverno.github.io/policy-reporter/core/api-reference/