Skip to main content
PUT
Update a finding

Authorizations

Authorization
string
header
required

Bearer token for authentication

Path Parameters

finding_id
string
required

ID of the finding

Body

application/json

Request to update a finding's lifecycle status

status
enum<string>
default:FINDING_STATUS_UNSPECIFIED

FindingStatus represents the lifecycle status of a finding. Transitions: OPEN → IN_PROGRESS → RESOLVED, or OPEN → REJECTED. A resolved finding can be reopened (back to OPEN) if it reappears in later evidence.

  • FINDING_STATUS_OPEN: OPEN: newly detected finding, not yet triaged or acted upon
  • FINDING_STATUS_IN_PROGRESS: IN_PROGRESS: finding is being investigated or actively remediated
  • FINDING_STATUS_RESOLVED: RESOLVED: finding has been fixed, mitigated, or otherwise closed (see resolution_reason for details)
  • FINDING_STATUS_REJECTED: REJECTED: finding has been dismissed by an operator (e.g. false positive, risk accepted, out of scope)
Available options:
FINDING_STATUS_UNSPECIFIED,
FINDING_STATUS_OPEN,
FINDING_STATUS_IN_PROGRESS,
FINDING_STATUS_RESOLVED,
FINDING_STATUS_REJECTED
status_detail
enum<string>
default:FINDING_STATUS_DETAIL_UNSPECIFIED
  • FINDING_STATUS_DETAIL_MIXED_ASSESSMENTS: Active assessments at the same scope level disagree on status
Available options:
FINDING_STATUS_DETAIL_UNSPECIFIED,
FINDING_STATUS_DETAIL_NEW,
FINDING_STATUS_DETAIL_TRIAGED,
FINDING_STATUS_DETAIL_REOPENED,
FINDING_STATUS_DETAIL_INVESTIGATING,
FINDING_STATUS_DETAIL_REMEDIATING,
FINDING_STATUS_DETAIL_AWAITING_VERIFICATION,
FINDING_STATUS_DETAIL_MIXED_ASSESSMENTS
resolution_reason
enum<string>
default:FINDING_RESOLUTION_REASON_UNSPECIFIED
Available options:
FINDING_RESOLUTION_REASON_UNSPECIFIED,
FINDING_RESOLUTION_REASON_FIXED,
FINDING_RESOLUTION_REASON_OBJECT_DELETED,
FINDING_RESOLUTION_REASON_MITIGATED,
FINDING_RESOLUTION_REASON_FALSE_POSITIVE,
FINDING_RESOLUTION_REASON_NOT_AFFECTED,
FINDING_RESOLUTION_REASON_RISK_ACCEPTED,
FINDING_RESOLUTION_REASON_WONT_FIX,
FINDING_RESOLUTION_REASON_DUPLICATE,
FINDING_RESOLUTION_REASON_OUT_OF_SCOPE

Response

A successful response.

Response for the Update method

result
FindingDetail · object

Full details of a security finding

Example: