Update a finding for an organization (admin)

PATCH /v1/admin/organizations/{orgId}/findings/{findingId}

Update a finding for an organization (admin)

cURL

curl --request PATCH \
  --url http://localhost:3333/v1/admin/organizations/{orgId}/findings/{findingId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "open",
  "type": "soc2",
  "content": "The uploaded evidence does not clearly show the Organization Name or URL.",
  "revisionNote": "Please provide clearer screenshots showing the timestamp."
}
'

Path Parameters

orgId · string · required

findingId · string · required

Body

application/json

status · enum<string>

Finding status

Available options: open, ready_for_review, needs_revision, closed

type · enum<string>

Type of finding (SOC 2 or ISO 27001)

Available options: soc2, iso27001

content · string

Finding content/message

Maximum string length: 5000

Example:

"The uploaded evidence does not clearly show the Organization Name or URL."

revisionNote · object

Auditor note when requesting revision (only for needs_revision status)

Example:

"Please provide clearer screenshots showing the timestamp."

Response

200 - undefined