Findings

Create audit finding

Changed on

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

post/v1/findings

Request

  • Base URL
    https://api.betayum.com
  • URL
    https://api.betayum.com/v1/findings
  • Auth
    API key in header X-API-Key

Request body

taskIdstring

Task ID

evidenceSubmissionIdstring

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

policyIdstring

Policy ID

vendorIdstring

Vendor ID

riskIdstring

Risk ID

memberIdstring

Member ID (person this finding targets)

deviceIdstring

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

contentstring required

Finding content/message

Changes

  • 912fecc0177cRevision changes
    • warning

      removed the request property

  • 6e22489e33cbRevision changes
    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status