Skip to main content

Record Review Action

Records a reviewer’s action on a specific compliance item.
POST /api/gov/submissions/:reviewId/actions

Request Body

FieldTypeRequiredDescription
itemIdstringYesThe compliance item ID
actionstringYesOne of: APPROVE, FLAG, REJECT, SKIP
notesstringNoReviewer notes explaining the action
codeReferencesstring[]NoArray of 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

Finalizes a review. The final status is determined by the review actions:
  • All approved: APPROVED
  • Any rejected: REJECTED
  • Any flagged (none rejected): NEEDS_RESPONSE
POST /api/gov/submissions/:reviewId/complete
No request body required. The submission must be in IN_REVIEW status with at least one recorded action.