> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bimengine.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Review Actions

> POST /api/gov/submissions/:reviewId/actions and /complete

## Record action

```bash theme={null}
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

```json theme={null}
{
  "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

```bash theme={null}
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**