---
title: "Review Inbox Action"
method: POST
path: "/automations/inbox/actions/{inbox_action_id}/review"
tags: ["Automations"]
---

# Review Inbox Action

`POST /automations/inbox/actions/{inbox_action_id}/review`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/automations/inbox/actions/{inbox_action_id}/review`
- Auth: none declared

Decide on a planned action. Approving a write queues it; approving a failed or skipped one retries it.

## Path parameters

- `inbox_action_id` string, uuid, required

## Request body

- ReviewInboxActionRequest
  - `decision` string, required
  - `note` string, nullable
  - `contact_id` integer, nullable
  - `source_kind` 'attorney' | 'other' | 'paid', nullable
  - `leave_out` string[]
  - `case_number` string, nullable

## Response `200`

Successful Response

- InboxActionSchema
  - `inbox_action_id` string, uuid, required
  - `inbox_matter_id` string, uuid, required
  - `action_type` string, required
  - `status` string, required
  - `was_dry_run` boolean, required
  - `title` string, required
  - `payload` object, required
  - `review_reasons` string[], required
  - `evidence` object, required
  - `sa_case_id` integer, nullable
  - `case_number` string, nullable
  - `reviewed_by` string, uuid, nullable
  - `reviewed_at` string, date-time, nullable
  - `review_note` string, nullable
  - `attempts` integer
  - `result` object
  - `error` string, nullable
  - `executed_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `parts` InboxActionPartSchema[]
    - `key` string, required
    - `label` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `78354dbadf92`: 3 info
  - added the new optional request property `case_number`
  - added the new optional request property `leave_out`
  - added the optional property `parts` to the response with the `200` status
- **2026-10-16** `c9ca07b3ac1e`: 6 info
  - added the new optional request property `contact_id`
  - added the new optional request property `source_kind`
  - added the optional property `attempts` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
  - …2 more
- **2026-10-15** `f88cd96236c1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/fastapi/changes/automations/inbox/actions/:inbox_action_id/review/post.md)

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openintake/apis/fastapi/revisions/71fe7bdfd1b0?raw)