> ## Documentation Index
> Fetch the complete documentation index at: https://docs-docflow.textin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> DocFlow API documentation changelog

## 2026-07-08

### API

#### Intelligent Review Model Update

* [Submit Review Task](/api-reference/intelligent-review/submit-review-task)

  * **Body**: The available values of the `model` parameter are updated to `deepseek-v4-pro`, `qwen3.6-plus`, `qwen3.7-max`, and `ORM-O1`.
    Starting July 8, 2026, the following legacy models were deprecated. Use the corresponding replacement model:

    | Legacy model  | Replacement model |
    | ------------- | ----------------- |
    | `deepseek-r1` | `deepseek-v4-pro` |
    | `qwq-32b`     | `qwen3.6-plus`    |
    | `qwen3-max`   | `qwen3.7-max`     |

  * **Response**: Added the `model` field, which returns the model actually used for the review task.
* [Get Review Task Result](/api-reference/intelligent-review/get-review-task-result) statistics now include `not_triggered_count`, which returns the number of review rules that were not triggered.

## 2026-07-05

### API

#### Extraction Model Upgrade

The extraction models have been uniformly renamed, and a new **Auto** intelligent routing option has been added. This affects all endpoints that contain `extract_model` (**Create File Category**, **Update File Category**, adding and updating file category fields/tables, **Extract Fields**, **Get File Results**).

| Old Model Name | New Model Name | Description                                                                                                        |
| -------------- | -------------- | ------------------------------------------------------------------------------------------------------------------ |
| Model 1        | `Acgpt`        | Fast speed with stable extraction results                                                                          |
| Model 2        | `DF-M1`        | Suitable for complex document understanding                                                                        |
| Model 3        | `Acgpt-VL`     | VLM, suitable for simple extraction (≤10 pages)                                                                    |
| —              | `Auto`         | Automatically matches the extraction model (new; the algorithm automatically routes to the actual model per field) |

* The request parameter `extract_model` only accepts the new model names (`Auto`/`Acgpt`/`Acgpt-VL`/`DF-M1`); the old values `Model 1`/`Model 2`/`Model 3` and the legacy code values `llm`/`vlm` are no longer supported.
* In the **Get File Results** and **Extract Fields** responses, fields and tables now include `configModel` (the configured model, which may be `Auto`; `null` for legacy data that was not configured); the original `extractModel` semantics have been adjusted to "actual hit model" (values `Acgpt`/`Acgpt-VL`/`DF-M1`).
* A new extraction failure reason "Exceeded Acgpt-VL processing limit" has been added (`Acgpt-VL` has a document-level processing cap, surfaced when e.g. the page count exceeds the limit).
* The extraction model `Acgpt-VL` does not currently support table multi-table merging (`collect_from_multi_table`).

## 2026-06-02

### API

#### Primary Endpoints Upgrade

Process multiple objects in a single request. All endpoints use **all-or-nothing** semantics — if any item fails validation, the entire batch is rejected.

| Endpoint                                                                                              | Description                          |
| ----------------------------------------------------------------------------------------------------- | ------------------------------------ |
| [Add File Category Fields](/api-reference/file-category/add-file-category-fields)                     | Create up to 100 fields at once      |
| [Update File Category Fields](/api-reference/file-category/update-file-category-fields)               | Update multiple field configs        |
| [Add File Category Tables](/api-reference/file-category/add-file-category-tables)                     | Create tables (with embedded fields) |
| [Update File Category Tables](/api-reference/file-category/update-file-category-tables)               | Update multiple table configs        |
| [Upload Category Samples](/api-reference/file-category-samples/upload-category-samples)               | Upload multiple samples (up to 20)   |
| [Download Category Samples (ZIP)](/api-reference/file-category-samples/download-category-samples-zip) | Download samples as ZIP              |

#### Deprecated Endpoints

The following single-item endpoints are now marked as `deprecated`. They remain functional but will no longer be maintained. Please migrate to the primary endpoints above:

| Deprecated                        | Replacement                                                                                           |
| --------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Add Single File Category Field    | [Add File Category Fields](/api-reference/file-category/add-file-category-fields)                     |
| Update Single File Category Field | [Update File Category Fields](/api-reference/file-category/update-file-category-fields)               |
| Add Single File Category Table    | [Add File Category Tables](/api-reference/file-category/add-file-category-tables)                     |
| Update Single File Category Table | [Update File Category Tables](/api-reference/file-category/update-file-category-tables)               |
| Upload Single Category Sample     | [Upload Category Samples](/api-reference/file-category-samples/upload-category-samples)               |
| Download Single Category Sample   | [Download Category Samples (ZIP)](/api-reference/file-category-samples/download-category-samples-zip) |

#### One-Step Category Creation

[Create File Category](/api-reference/file-category/create-file-category) now accepts a `tables` parameter — configure tables and their fields in a single call when creating a category.

#### Field Advanced Config

[Update File Category Field](/api-reference/file-category/update-file-category-field) (single + [batch](/api-reference/file-category/batch-update-file-category-fields)) now support these properties:

| Property                   | Description             | Update Semantics                                 |
| -------------------------- | ----------------------- | ------------------------------------------------ |
| `alias`                    | Field aliases           | omit=no change, `[]`=clear, `["a","b"]`=override |
| `identity`                 | Export field name       | omit=no change, `""`=clear, non-empty=override   |
| `multi_value`              | Multi-value extraction  | omit=no change, `true`/`false`=override          |
| `duplicate_value_distinct` | Deduplicate values      | Only effective when `multi_value=true`           |
| `transform_settings`       | Output transform config | Supports datetime / enumerate / regex            |

#### Enriched Responses

Get full config without extra queries:

* [Get File Category Field List](/api-reference/file-category/get-file-category-field-list) — added `enabled`, `prompt`, `use_prompt`, `extract_model`, `alias`, `identity`, `multi_value`, `duplicate_value_distinct`, `transform_settings`
* [Get File Category Table List](/api-reference/file-category/get-file-category-table-list) — added `prompt`, `collect_from_multi_table`, `extract_model`
* [List File Categories](/api-reference/file-category/list-file-categories) — added `category_prompt`, `extract_model`
* **with\_detail flag** — pass `with_detail=true` on create/update to get the complete object in the response

### SDK

* Python SDK `fields.update()` and `fields.batch_update()` — added advanced config parameters and clear semantics examples

## 2026-05-27

**API**

* Updated: [Upload File](/api-reference/upload-file), [Upload File Synchronously](/api-reference/upload-file-synchronously) endpoints now support `parser_parse_mode` parameter for specifying parse mode (auto/scan/VLM)
* Updated: [Upload File](/api-reference/upload-file), [Upload File Synchronously](/api-reference/upload-file-synchronously) endpoints now support `parser_pdf_pwd` parameter for decrypting encrypted PDF files
* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) response now includes `parser_params` field showing file parsing parameter configuration

## 2026-05-06

**Guides**

* Updated: [Expense Reimbursement (From Scratch)](/docflow-global/cn/00-overview/expense_reimbursement), [AP Review (From Scratch)](/docflow-global/cn/00-overview/ap_review), [Contract Review (From Scratch)](/docflow-global/cn/00-overview/contract_review) — improved review rule risk level indicators and descriptions
* Added: Changelog page

## 2026-04-30

**Guides**

* Updated: [Expense Reimbursement (From Scratch)](/docflow-global/cn/00-overview/expense_reimbursement), [Expense Reimbursement (Pre-configured)](/docflow-global/cn/00-overview/expense_reimbursement_already_configured), [AP Review (From Scratch)](/docflow-global/cn/00-overview/ap_review), [AP Review (Pre-configured)](/docflow-global/cn/00-overview/ap_review_already_configured), [Contract Review (From Scratch)](/docflow-global/cn/00-overview/contract_review), [Contract Review (Pre-configured)](/docflow-global/cn/00-overview/contract_review_already_configured) — added **synchronous upload** [Upload File Synchronously](/api-reference/upload-file-synchronously) code examples (Python + Java) to the upload step, with comparison between async and sync modes
* Updated: Example code files (`expense_reimbursement.py`, `contract_review.py`, `ap_review.py` and their `_configured` variants) now include `upload_file_sync` function

## 2026-04-16

**API**

* Updated: Review API upgraded to v2.1 — improved schema definitions for [Submit Review Task](/api-reference/intelligent-review/submit-review-task), [Get Review Task Result](/api-reference/intelligent-review/get-review-task-result) and related APIs

## 2026-04-15

**API**

* Updated: [Upload File](/api-reference/upload-file), [Upload File Synchronously](/api-reference/upload-file-synchronously), [Retry File Processing](/api-reference/retry-file-processing) endpoints now support `parser_dpi` parameter for custom document parsing resolution

## 2026-04-14

**Guides**

* Updated: [File Format Support](/docflow-global/en/01-upload/support_format), [Upload by URLs](/docflow-global/en/01-upload/upload_by_urls) — file upload size limit increased from 50MB to **100MB**

**API**

* Updated: [Upload File](/api-reference/upload-file), [Upload File Synchronously](/api-reference/upload-file-synchronously) max file size adjusted to 100MB

## 2026-04-12

**Guides**

* Added: [Entity Extraction vs Docflow](/docflow-global/cn/00-overview/atomic_capabilities_extract) — Atomic Capability: Entity Extraction, with comparison to Docflow extraction workflow
* Added: [Document Parse vs Docflow](/docflow-global/cn/00-overview/atomic_capabilities_parse) — Atomic Capability: Document Parse, with comparison to Docflow parse workflow

## 2026-04-08

**SDK**

* Added: Python SDK documentation

## 2026-04-07

**Guides**

* Updated: All 6 scenario guides ([Expense Reimbursement](/docflow-global/cn/00-overview/expense_reimbursement), [AP Review](/docflow-global/cn/00-overview/ap_review), [Contract Review](/docflow-global/cn/00-overview/contract_review) and their pre-configured versions) with improved titles, descriptions, and sample file references
* Added: Java example code (`ApReview.java`, `ContractReview.java`, etc. — 6 files) and corresponding sample documents

## 2026-04-03

**Guides**

* Added: [AP Review (From Scratch)](/docflow-global/cn/00-overview/ap_review) — with Python/Java examples
* Added: [AP Review (Pre-configured)](/docflow-global/cn/00-overview/ap_review_already_configured)
* Added: [Contract Review (From Scratch)](/docflow-global/cn/00-overview/contract_review) — with Python/Java examples
* Added: [Contract Review (Pre-configured)](/docflow-global/cn/00-overview/contract_review_already_configured)
* Added: [Expense Reimbursement (Pre-configured)](/docflow-global/cn/00-overview/expense_reimbursement_already_configured)
* Added: `entity_extraction.py` — standalone Entity Extraction API example

**API**

* Updated: [Workspace management](/api-reference/workspace-management/get-workspace-list) endpoints no longer require `enterprise_id` parameter

## 2026-04-01

**API**

* API documentation upgraded to **v2.4.0**
* Added (EN): Complete workspace management and category management REST API endpoints
* Added: [Amend File Category](/api-reference/amend-file-category), [Get File Category Tables List](/api-reference/file-category/get-file-category-tables-list), [Add File Category Table](/api-reference/file-category/add-file-category-table), [Update File Category Table](/api-reference/file-category/update-file-category-table), [Delete File Category Tables](/api-reference/file-category/delete-file-category-tables) endpoints

## 2026-03-24

**Guides**

* Added: [Expense Reimbursement (From Scratch)](/docflow-global/cn/00-overview/expense_reimbursement) — with flow diagrams and Python/Java examples
* Updated: [Quick Start](/docflow-global/en/00-overview/quickstart)

## 2026-03-12

**Guides**

* Added: [Workspace Management - Quickstart](/docflow-global/en/02-workspace/quickstart)
* Added: [Category Management - Quickstart](/docflow-global/en/10-category-management/quickstart)
* Added: [Fields Management](/docflow-global/en/10-category-management/fields_management)
* Added: [Tables Management](/docflow-global/en/10-category-management/tables_management)
* Added: [Samples Management](/docflow-global/en/10-category-management/samples_management)

**API**

* API documentation upgraded to **v2.3.0**
* Added endpoints: [Update File Processing Result](/api-reference/update-file-processing-result), [Extract Specific Fields](/api-reference/extract-specific-fields), [Retry File Processing](/api-reference/retry-file-processing), [Generate a Short-Lived Token](/api-reference/generate-a-short-lived-token), workspace CRUD, category CRUD, [Get File Category Tables List](/api-reference/file-category/get-file-category-tables-list), [Add File Category Table](/api-reference/file-category/add-file-category-table), [Update File Category Table](/api-reference/file-category/update-file-category-table), [Delete File Category Tables](/api-reference/file-category/delete-file-category-tables)
* Added review endpoints: [Review Rule Repository](/api-reference/intelligent-review/get-review-rule-repository-list), [Review Rule Group](/api-reference/intelligent-review/create-review-rule-group), [Review Rule](/api-reference/intelligent-review/create-review-rule), [Review Task](/api-reference/intelligent-review/submit-review-task)

## 2026-03-02

**API**

* API documentation upgraded to **v2.2.0**
* Added endpoints: [Create Workspace](/api-reference/workspace-management/create-workspace), [Create File Category](/api-reference/file-category/create-file-category), [Add File Category Field](/api-reference/file-category/add-file-category-field)

## 2026-02-03

**Guides**

* Added: [前端 iframe 嵌入](/docflow-global/cn/10-web/iframe)

## 2026-01-28

**API**

* Added workspace management endpoints: [Create Workspace](/api-reference/workspace-management/create-workspace), [Get Workspace List](/api-reference/workspace-management/get-workspace-list), [Get Workspace Details](/api-reference/workspace-management/get-workspace-details), [Update Workspace](/api-reference/workspace-management/update-workspace), [Delete Workspace](/api-reference/workspace-management/delete-workspace)
* Added category management endpoints: [Create File Category](/api-reference/file-category/create-file-category), [Update File Category](/api-reference/file-category/update-file-category), [Delete File Category](/api-reference/file-category/delete-file-category), [Upload Category Sample](/api-reference/file-category-samples/upload-category-sample), [Get Category Samples List](/api-reference/file-category-samples/get-category-samples-list), [Download Category Sample](/api-reference/file-category-samples/download-category-sample)
* Added category field management endpoints: [Add File Category Field](/api-reference/file-category/add-file-category-field), [Update File Category Field](/api-reference/file-category/update-file-category-field), [Delete File Category Fields](/api-reference/file-category/delete-file-category-fields)

## 2026-01-27

**Guides**

* Added: [OpenAPI File Download](/docflow-global/en/100-faq/openapi_download)

## 2026-01-21

**API**

* Updated: [Generate a Short-Lived Token](/api-reference/generate-a-short-lived-token) endpoint now supports expiration time configuration
* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) response now includes `total_page_num` field

## 2025-12-25

**Guides**

* Updated: [Create Review Task](/docflow-global/en/07-review/create_task) — added `batch_number` parameter documentation

**API**

* Updated: [Submit Review Task](/api-reference/intelligent-review/submit-review-task) now accepts `batch_number` parameter
* Updated: [Upload File](/api-reference/upload-file), [Upload File Synchronously](/api-reference/upload-file-synchronously), [Retry File Processing](/api-reference/retry-file-processing) endpoints now support image processing parameters (`parser_remove_watermark`, `parser_crop_dewarp`, etc.)

## 2025-12-24

**Guides**

* Added: [Rule Repository Management](/docflow-global/en/07-review/rule_management) — CRUD for rule repos, rule groups, and rules
* Added: [Create Review Task](/docflow-global/en/07-review/create_task)
* Added: [Get Review Results](/docflow-global/en/07-review/get_result)
* Added: [Retry Review Task](/docflow-global/en/07-review/retry_task)
* Updated: [Review - Quick Start](/docflow-global/en/07-review/quickstart)

**API**

* Added endpoints: [Get Review Rule Repository List](/api-reference/intelligent-review/get-review-rule-repository-list), [Get Review Rule Repository](/api-reference/intelligent-review/get-review-rule-repository), [Retry Review Task](/api-reference/intelligent-review/retry-review-task), [Retry Specific Rule in Review Task](/api-reference/intelligent-review/retry-specific-rule-in-review-task)
* Removed: Legacy review API

## 2025-12-19

**Guides**

* Added: [Synchronous Upload](/docflow-global/en/01-upload/upload_sync)

**API**

* Added endpoint: [Upload File Synchronously](/api-reference/upload-file-synchronously)
* Added endpoints: [Get Workspace File Category List](/api-reference/file-category/get-workspace-file-category-list), [Get File Category Fields List](/api-reference/file-category/get-file-category-fields-list)
* Added review rule repo endpoints: [Create Review Rule Repository](/api-reference/intelligent-review/create-review-rule-repository), [Delete Review Rule Repository](/api-reference/intelligent-review/delete-review-rule-repository), [Update Review Rule Repository](/api-reference/intelligent-review/update-review-rule-repository)

## 2025-12-17

**Guides**

* Added: [Extract Specific Fields](/docflow-global/en/06-extract/extract_specific_fields)
* Updated: [Extract - Quick Start](/docflow-global/en/06-extract/quickstart)

**API**

* Added endpoint: [Extract Specific Fields](/api-reference/extract-specific-fields)
* Removed: Legacy review API endpoints

## 2025-12-11

**Guides**

* Added: [Enterprise Multi-Tenant](/docflow-global/en/00-overview/enterprise_multi_tenant)
* Added: [How to Get Enterprise ID](/docflow-global/en/100-faq/get_enterprise_id)

## 2025-12-08

**Guides**

* Added: [File Retry - Quick Start](/docflow-global/en/09-retry/quickstart)

**API**

* Added endpoint: [Retry File Processing](/api-reference/retry-file-processing)

## 2025-11-12

**API**

* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) response now includes export field name (`export_name`)

## 2025-11-04

**Guides**

* Added: [Amend File Category](/docflow-global/en/04-classify/amend_category)
* Added: [Amend File Category (File Split)](/docflow-global/en/05-split/amend_category_split)
* Added: [Amend File Category (Multi-Image Crop)](/docflow-global/en/05-split/amend_category_crop)

**API**

* Added endpoint: [Amend File Category](/api-reference/amend-file-category)

## 2025-10-27

**Guides**

* Added: [Upload by URLs](/docflow-global/en/01-upload/upload_by_urls)
* Added: [Task Status Query](/docflow-global/en/01-upload/task_status) — including failure reasons and duration
* Updated: [Response JSON Structure](/docflow-global/en/01-upload/response) — added `task_id` field documentation

**API**

* Updated: [Upload File](/api-reference/upload-file) now supports URL-based upload (`urls` request body)
* Updated: [Upload File](/api-reference/upload-file) response now includes `task_id` field
* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) response now includes `failure_causes` and `duration_ms` fields
* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) table coordinate structure unified with fields and items

## 2025-10-16

**Guides**

* Added: [File Deletion - Quick Start](/docflow-global/en/08-delete/quickstart)

**API**

* Added endpoint: [Delete Tasks](/api-reference/delete-tasks)

## 2025-09-01 \~ 2025-09-05

**Guides**

* Added: Full English documentation launched (25+ pages covering [Product Introduction](/docflow-global/en/00-overview/intro), [Upload](/docflow-global/en/01-upload/quickstart), [Parse](/docflow-global/en/03-parse/quickstart), [Classify](/docflow-global/en/04-classify/quickstart), [Split](/docflow-global/en/05-split/quickstart), [Extract](/docflow-global/en/06-extract/quickstart), [Review](/docflow-global/en/07-review/quickstart), FAQ)
* Updated: [Multi-Image Cropping](/docflow-global/en/05-split/crop) — split results now include page number and rotation angle for cropped images

**API**

* Added: English OpenAPI specification

## 2025-08-26 \~ 2025-08-28

**Guides**

* Added: [Classification - Quick Start](/docflow-global/cn/04-classify/quickstart)
* Added: [Classification Only](/docflow-global/cn/04-classify/target_process)
* Added: [Specify Classification Upload](/docflow-global/cn/04-classify/manual)
* Added: [Split - Quick Start](/docflow-global/cn/05-split/quickstart)
* Added: [File Splitting](/docflow-global/cn/05-split/split)
* Added: [Multi-Image Cropping](/docflow-global/cn/05-split/crop)
* Added: [Extract - Quick Start](/docflow-global/cn/06-extract/quickstart)
* Added: [Basic Field Information](/docflow-global/cn/06-extract/fields)
* Added: [Table Field Information](/docflow-global/cn/06-extract/tables)
* Added: [Stamp Information](/docflow-global/cn/06-extract/stamps)
* Added: [Handwriting Information](/docflow-global/cn/06-extract/handwritings)
* Added: [Coordinate System](/docflow-global/cn/03-parse/coordinate)
* Added: FAQ pages — [How to Get Workspace ID](/docflow-global/cn/100-faq/get_workspace_id), [How to Configure File Categories](/docflow-global/cn/100-faq/setup_category), [Chinese Category Parameter Issues](/docflow-global/cn/100-faq/chinese_category_param), [Product Pricing](/docflow-global/cn/100-faq/product_charge)

## 2025-08-14

**Guides**

* Added: [Document Parse - Quick Start](/docflow-global/cn/03-parse/quickstart)
* Added: [Parsing Result Visualization](/docflow-global/cn/03-parse/visualization)
* Added: [Response JSON Structure](/docflow-global/cn/01-upload/response)

## 2025-08-13

**Guides**

* DocFlow API documentation site launched:
  * [Product Introduction](/docflow-global/cn/00-overview/intro)
  * [Quick Start](/docflow-global/cn/00-overview/quickstart)
  * [Access Credentials](/docflow-global/cn/00-overview/auth)
  * [Upload - Quick Start](/docflow-global/cn/01-upload/quickstart)
  * [File Format Support](/docflow-global/cn/01-upload/support_format)
  * [Workspace Management](/docflow-global/cn/02-workspace/quickstart)
  * [Review - Quick Start](/docflow-global/cn/07-review/quickstart)

**API**

* Initial API documentation published with [Upload File](/api-reference/upload-file) and [Get File Processing Result List](/api-reference/get-file-processing-result-list) endpoints

## 2025-07-09

**API**

* Fixed: Table and stamp result field definitions

## 2025-05-20 \~ 2025-05-21

**API**

* Updated: [Upload File](/api-reference/upload-file) now supports `split_flag` (file split) and `crop_flag` (multi-image crop) parameters
* Updated: [Upload File](/api-reference/upload-file) now supports `auto_verify_vat` (automatic VAT invoice verification) parameter
* Updated: [Upload File](/api-reference/upload-file) now supports `target_process` parameter for pipeline control (classify-only / classify+extract)
* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) response now supports sub-tasks and sub-image coordinates

## 2025-05-07 \~ 2025-05-12

**API**

* Added APIs (legacy): [Submit Review Task](/api-reference/intelligent-review/submit-review-task), [Update Review Rule](/api-reference/intelligent-review/update-review-rule), `runRule` — Review API

## 2025-04-15

**API**

* Updated: [Get Workspace File Category List](/api-reference/file-category/get-workspace-file-category-list) endpoint added `enabled` filter parameter
* Added: [Get File Processing Result List](/api-reference/get-file-processing-result-list) API documentation
* Fixed: Stamp, handwriting, and table field definitions

## 2025-02-18

**API**

* Added endpoints: [Create Workspace](/api-reference/workspace-management/create-workspace), [Get Workspace List](/api-reference/workspace-management/get-workspace-list), [Get Workspace Details](/api-reference/workspace-management/get-workspace-details), [Update Workspace](/api-reference/workspace-management/update-workspace), [Delete Workspace](/api-reference/workspace-management/delete-workspace) — Workspace management
* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) response now includes `task_id` field

## 2025-01-02 \~ 2025-01-03

**API**

* Added endpoint: [Update File Processing Result](/api-reference/update-file-processing-result) — Update file extraction results with batch update support
* Updated: [Get File Processing Result List](/api-reference/get-file-processing-result-list) field extraction results now include `position` coordinate information

## 2024-12-20 \~ 2024-12-23

**API**

* DocFlow API initial release
* [Upload File](/api-reference/upload-file) endpoint uses `multipart/form-data` format with multi-file upload support
* Authentication signature examples (Python)
