Skip to content
Proud to collaborate with Microsoft for Startups

audit.audit-run.archive ​

Archive an audit scan run using the soft-delete lifecycle.

Overview ​

PropertyValue
Workflow typeAtomic
LibraryApp-audit
Version1.0

Input Schema ​

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

Output Schema ​

FieldTypeRequiredDefaultDescription
organization_uuiduuidYes—UUID of the organization that owns the audit record
audit_run_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
deletedSUCCESSAudit run soft-deleted or archivedaudit_run_uuid
failedFAILUREAudit workflow failedfailure_reason

API Usage ​

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

{
  "workflow_type": "audit.audit-run.archive",
  "initial_data": {
    "organization_uuid": "value",
    "audit_run_uuid": "value"
  }
}