---
title: "Update Severity Rating"
method: POST
path: "/api/v2/issues/updateSeverityRating"
tags: ["Issues"]
---

# Update Severity Rating

`POST /api/v2/issues/updateSeverityRating`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/issues/updateSeverityRating`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Set the severity *rating* (the ZeroPath score label shown on the issue) of a single issue, e.g. downgrade a "High" to "Medium". Use this when a user asks to reassess or change an issue's severity by label. The rating is one of "critical", "high", "medium", "low", or "info" ("medium" is displayed as "Medium"/"Moderate"). The ZeroPath score is the composite of the raw severity and the scanner's confidence, so this endpoint adjusts the underlying severity to land the score in the requested band, recording the confidence it scored with. Prefer this over updateSeverity whenever you want the displayed rating to change: updateSeverity sets only the raw 0-10 number, which cannot lift a finding with no recorded confidence out of the Informational band. Because confidence caps the maximum reachable score, rating a low-confidence finding *up* into a high band can be rejected; downgrades always apply.

## Request body

- object
  - `organizationId` string
  - `issueId` string, required
  - `rating` 'critical' | 'high' | 'medium' | 'low' | 'info', required: Target ZeroPath severity rating for the issue.
  - `reason` string

## Response `200`

Severity rating updated

- object
  - `ok` boolean

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)