Approve or deny a proposed AI change during human-in-the-loop (HITL) review.
When a job has status ‘awaiting_approval’, the AI has proposed document changes that require user review. Poll GET /v1/jobs/ to see the pending_changes in the result field, then call this endpoint to approve or deny.
For single changes: set approved=true/false and optionally provide feedback. For batch changes: provide a ‘changes’ array with per-change decisions. After approval, the job resumes processing and eventually reaches ‘completed’.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Approve or deny proposed AI document changes.
Job ID that is awaiting approval.
Whether to approve (true) or deny (false) the change.
Specific change to approve/deny (for individual decisions). Get change IDs from the job's pending_changes.
Optional feedback explaining why a change was denied. Helps the AI adjust future suggestions.
Batch decisions: array of {change_id, approved, feedback} objects. Use for 'Accept All' or 'Deny All'.
Successful Response