Skip to main content
Version: 1.0.0-beta

Field Reference — Engagements

Engagement Fields​

FieldTypeRequiredDescription
idIntegerAutoUnique identifier
titleString✅Engagement title
objectiveTextOptionalAudit objective statement
scopeTextOptionalScope definition
statusStringAutoDRAFT, PLANNED, FIELDWORK, REPORTING, REVIEW, FINAL, CLOSED
phaseStringAutoCurrent phase: PLANNING, FIELDWORK, REPORTING, WRAP_UP
start_dateDateTimeOptionalEngagement start date
end_dateDateTimeOptionalEngagement end date
lead_auditor_idString✅Lead auditor user ID
org_idIntegerAutoOrganization for data isolation
business_unit_idIntegerOptionalLinked business unit
project_idIntegerOptionalLinked project (from annual plan)

Engagement Risk Fields​

FieldTypeRequiredDescription
idIntegerAutoUnique identifier
engagement_idInteger✅Parent engagement
titleString✅Risk title
descriptionString✅Risk description
impactString✅Impact level
likelihoodString✅Likelihood level
library_risk_idIntegerOptionalLink to risk library for traceability

Engagement Control Fields​

FieldTypeRequiredDescription
idIntegerAutoUnique identifier
engagement_risk_idInteger✅Parent risk
titleString✅Control title
descriptionString✅Control description
typeString✅Preventive or Detective
library_control_idIntegerOptionalLink to control library

Status Transitions​

Engagement Status​

Engagement Phase​

PLANNING → FIELDWORK → REPORTING → WRAP_UP