---
title: "Create a finding (auditor or platform admin only)"
method: POST
path: "/v1/findings"
tags: ["Findings"]
---

# Create a finding (auditor or platform admin only)

`POST /v1/findings`

## Request body

- CreateFindingDto
  - `taskId` string — Task ID
  - `evidenceSubmissionId` string — Evidence submission ID
  - `evidenceFormType` 'board-meeting' | 'it-leadership-meeting' | 'risk-committee-meeting' | 'meeting' | 'access-request' | 'whistleblower-report' | 'penetration-test' | 'rbac-matrix' | 'infrastructure-inventory' | 'employee-performance-evaluation' | 'network-diagram' | 'tabletop-exercise' — Evidence form type
  - `policyId` string — Policy ID
  - `vendorId` string — Vendor ID
  - `riskId` string — Risk ID
  - `memberId` string — Member ID (person this finding targets)
  - `deviceId` string — Device ID
  - `area` 'people' | 'documents' | 'compliance' | 'risks' | 'vendors' | 'policies' | 'other' — Broad area when the finding is not tied to a specific item
  - `type` 'soc2' | 'iso27001', required — Type of finding (SOC 2 or ISO 27001)
  - `severity` 'low' | 'medium' | 'high' | 'critical' — Severity
  - `templateId` string — Finding template ID
  - `content` string, required — Finding content/message

## Response `201`

## Changes

- **2026-04-20** `6e22489e33cb` — 1 warning, 10 info
  - removed the request property `scope`
  - added the new optional request property `area`
  - added the new optional request property `deviceId`
  - added the new optional request property `memberId`
  - …7 more
- **2026-04-16** `ac8d1e4e2e79` — 1 info
  - added the new optional request property `scope`

[Change history](https://skmtc.dev/trycompai/apis/comp-ai-api/changes/v1/findings/post.md)

---

[API](https://skmtc.dev/trycompai/apis/comp-ai-api.md) · [All operations](https://skmtc.dev/trycompai/apis/comp-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trycompai/comp-ai-api/revisions/ef13f9ae48ef/schema)