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/