---
title: "Review Automation Run"
method: POST
path: "/automations/{automation_run_id}/review"
tags: ["Automations"]
---

# Review Automation Run

`POST /automations/{automation_run_id}/review`

Approve or reject a proposed/needs-review action.

Approving queues live execution of the proposed action (even if the run
was a dry run — approval is the explicit human go-ahead). An approval may
carry overrides — a different destination folder, a new lead folder to
create, or a different filename — which is also how a needs-matching run
(no proposal at all) gets filed: the reviewer's answer becomes the
proposal. Rejecting parks it permanently.

## Path parameters

- `automation_run_id` string, uuid, required

## Request body

- AutomationRunReviewRequest — Approve or reject a proposed/needs-review action. An approval may carry overrides — the reviewer redirecting the filing to a folder/name of their choosing, or supplying the destination a needs-matching run couldn't determine. Exactly one destination override may be set: an existing folder (folder_id) or a new lead folder to create (create_folder_name). Overrides are how a run with no proposal at all becomes executable: the human's answer IS the proposal.
  - `decision` string, required — 'approve' or 'reject'
  - `folder_id` string, nullable
  - `create_folder_name` string, nullable
  - `filename` string, nullable

## Response `200`

Successful Response

- AutomationRunDetail — Run detail: adds the agent trace and IDs for deep links.
  - `automation_run_id` string, uuid, required
  - `action_type` string, required
  - `source_type` string, required
  - `source_id` string, uuid, required
  - `run_status` string, required
  - `was_dry_run` boolean, required
  - `review_status` string, nullable
  - `proposed_folder_path` string, nullable
  - `proposed_filename` string, nullable
  - `confidence` number, nullable
  - `reasoning` string, nullable
  - `error` string, nullable
  - `executed_at` string, date-time, nullable
  - `occurred_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `source_label` string, nullable
  - `can_approve` boolean
  - `can_reject` boolean
  - `review_blocked_reason` string, nullable
  - `proposed_folder_id` string, nullable
  - `executed_file_id` string, nullable
  - `trace` object[], nullable
  - `input_tokens` integer, nullable
  - `output_tokens` integer, nullable
  - `matched_drive_matter_id` string, uuid, nullable
  - `match_method` string, nullable
  - `match_evidence` string, nullable
  - `proposed_payload` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)