Skip to content
Proud to collaborate with Microsoft for Startups

audit.finding.delete ​

Soft-delete an audit finding.

Overview ​

PropertyValue
Workflow typeAtomic
LibraryApp-audit
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidYes—UUID of the organization that owns the audit record
finding_uuiduuidYes——

Output Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidYes—UUID of the organization that owns the audit record
finding_uuiduuidYes——
foundbooleanNo——
deletedbooleanNo——
archivedbooleanNo——
already_deletedbooleanNo——
deleted_atstringNo——
mismatchbooleanNo——
failure_reasonstringNo——
failure_typestringNo——
failed_actionstringNo——
failed_at_statestringNo——
failed_stepstringNo——
failed_layerstringNo——
errorstringNo——
error_typestringNo——

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—delete—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
pendingdeletecompleted—
* (any state)failfailed—

Outcomes ​

OutcomeTypeDescriptionState Data Keys
deletedSUCCESSFinding soft-deleted or archivedfinding_uuid
failedFAILUREAudit workflow failedfailure_reason

API Usage ​

bash
POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "audit.finding.delete",
  "initial_data": {
    "organization_uuid": "value",
    "finding_uuid": "value"
  }
}