Update a finding (status transition rules | Comp AI API

Update a finding (status transition rules apply) in Comp AI. Create, review, update, and track audit findings, remediation activity, and finding history.

PATCH /v1/findings/{id}

Update a finding (status transition rules apply)

cURL

curl --request PATCH \
  --url https://api.trycomp.ai/v1/findings/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "content": "<string>",
  "revisionNote": {}
}
'

Authorizations

apikeyoauth2

X-API-Key · string · header · required

API key for authentication

Path Parameters

id · string · required

Finding ID

Body

application/json

status · enum<string>

Finding status

Available options: open, ready_for_review, needs_revision, closed

type · enum<string>

Finding type

Available options: soc2, iso27001, pci_dss, hipaa, gdpr, iso9001, iso42001

severity · enum<string>

Severity

Available options: low, medium, high, critical

content · string

Finding content/message

Maximum string length: 5000

revisionNote · object

Auditor note when requesting revision

Response

200 - undefined