---
title: "Audit based on resource group."
method: GET
path: "/rest-api/v1/insight/audit"
tags: ["insight"]
---

# Audit based on resource group.

`GET /rest-api/v1/insight/audit`

This endpoint audits based on the specified resource group.

## Query parameters

- `cluster` string
- `apiVersion` string
- `kind` string
- `namespace` string
- `name` string
- `forceNew` boolean

## Response `200`

Audit results

- AiAuditData
  - `bySeverity` object
  - `issueGroups` AiIssueGroup[]
    - `issue` ScannerIssue
      - `message` string — Message provides a detailed human-readable description of the issue.
      - `scanner` string — Scanner is the name of the scanner that discovered the issue.
      - `severity` integer — Severity indicates how critical the issue is, using the IssueSeverityLevel constants.
      - `title` string — Title is a brief summary of the issue.
    - `resourceGroups` EntityResourceGroup[]
      - `annotations` object
      - `apiVersion` string
      - `cluster` string
      - `kind` string
      - `labels` object
      - `name` string
      - `namespace` string
      - `status` string
  - `issueTotal` integer
  - `resourceTotal` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2023-12-29** `fa4b9c305a29` — 1 info
  - endpoint added
- **2023-12-11** `2a20fa0acab4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/kusionstack/apis/karpor/changes/rest-api/v1/insight/audit/get.md)

---

[API](https://skmtc.dev/kusionstack/apis/karpor.md) · [All operations](https://skmtc.dev/kusionstack/apis/karpor/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kusionstack/karpor/revisions/d741ac56c269/schema)