---
title: "Create audit finding"
method: POST
path: "/v1/findings"
tags: ["Findings"]
---

# Create audit finding

`POST /v1/findings`

Create an audit finding so teams can track issue ownership, remediation activity, severity, and supporting evidence.

## 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
  - `content` string, required — Finding content/message

## Response `201`

## Changes

- **2026-05-10** `912fecc0177c` — 1 warning
  - removed the request property `templateId`
- **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`
- **2026-03-05** `946edaa856a9` — 1 warning
  - deleted the `header` request parameter `X-Organization-Id`

[Change history](https://skmtc.dev/om-network/apis/betayum-api/changes/v1/findings/post.md)

---

[API](https://skmtc.dev/om-network/apis/betayum-api.md) · [All operations](https://skmtc.dev/om-network/apis/betayum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/om-network/betayum-api/revisions/95679a9aa625/schema)