Review Actions - BIM Engine

Record action

POST /api/gov/submissions/:reviewId/actions

Body

Field	Type	Required	Description
`itemId`	`string`	Yes	Compliance item ID
`action`	`string`	Yes	`APPROVE`, `FLAG`, `REJECT`, or `SKIP`
`notes`	`string`	No	Reviewer notes
`codeReferences`	`string[]`	No	Code section references

Response

{
  "id": "act_abc123",
  "reviewId": "sub_abc123",
  "itemId": "item_xyz",
  "action": "APPROVE",
  "notes": "Meets IBC 2021 Section 903.2",
  "codeReferences": ["903.2"],
  "reviewerId": "user_456",
  "createdAt": "2026-03-01T14:30:00Z"
}

Complete review

POST /api/gov/submissions/:reviewId/complete

No body. Submission must be IN_REVIEW with at least one action recorded.

Completion logic

All approved: APPROVED
Any rejected: REJECTED
Any flagged (none rejected): NEEDS_RESPONSE