Sign in
Automations

Review Automation Run

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.

post/automations/{automation_run_id}/review

Path parameters

automation_run_idstring uuid required

Request body

decisionstring required

'approve' or 'reject'

folder_idstring nullable
create_folder_namestring nullable
filenamestring nullable

Response

Successful Response

automation_run_idstring uuid required
action_typestring required
source_typestring required
source_idstring uuid required
run_statusstring required
was_dry_runboolean required
review_statusstring nullable
proposed_folder_pathstring nullable
proposed_filenamestring nullable
confidencenumber nullable
reasoningstring nullable
errorstring nullable
executed_atstring date-time nullable
occurred_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required
source_labelstring nullable
can_approveboolean
can_rejectboolean
review_blocked_reasonstring nullable
proposed_folder_idstring nullable
executed_file_idstring nullable
traceobject[] nullable
input_tokensinteger nullable
output_tokensinteger nullable
matched_drive_matter_idstring uuid nullable
match_methodstring nullable
match_evidencestring nullable
proposed_payloadobject nullable

Changes

No recorded changes to this endpoint across all 1 revision of this API.