---
title: "Approve or deny AI-proposed document changes one-by-one or in batch (HITL workflow)."
method: POST
path: "/v1/chat/{session_id}/approve"
tags: ["v1", "mcp", "approval"]
---

# Approve or deny AI-proposed document changes one-by-one or in batch (HITL workflow).

`POST /v1/chat/{session_id}/approve`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/chat/{session_id}/approve`
- Auth: HTTP bearer

Used with chat_async when approval_mode='ask_every_time'. For each proposed change (with chunk_id and HTML diff), respond approved=true|false plus optional feedback for the AI to revise on. Approved changes apply atomically; denied changes are discarded; the AI may revise based on feedback in the next turn. Required for regulated workflows (legal, medical, compliance) where every AI edit must be reviewed before it touches the document. For single changes: set approved=true/false and optionally provide feedback. For batch decisions: provide a 'changes' array with per-change decisions. After approval, the job resumes processing and eventually reaches status=completed.

## Path parameters

- `session_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- ApprovalRequest: Approve or deny proposed AI document changes.
  - `job_id` string, required: Job ID that is awaiting approval.
  - `change_id` string, nullable: Specific change to approve/deny (for individual decisions). Get change IDs from the job's pending_changes.
  - `approved` boolean, required: Whether to approve (true) or deny (false) the change.
  - `feedback` string, nullable: Optional feedback explaining why a change was denied. Helps the AI adjust future suggestions.
  - `changes` object[], nullable: Batch decisions: array of {change_id, approved, feedback} objects. Use for 'Accept All' or 'Deny All'.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)