cURL

curl --request POST \
  --url https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "app_id": "app_1406",
  "app_name": "Purchase order extraction app (new version)",
  "config_version": "v1",
  "app_label": [
    "purchase-order"
  ],
  "extract_fields": [
    {
      "field_name": "Order number",
      "field_type": "string",
      "field_prompt": "Extract the purchase order number."
    },
    {
      "field_name": "Supplier name",
      "field_type": "string",
      "field_prompt": "Extract the supplier name."
    }
  ],
  "parse_mode": "fast_vlm",
  "enable_highlight": 1,
  "enable_pdf_parse": true,
  "pdf_pic_second_parsing": false,
  "enable_stamp_recognition": true,
  "enable_long_doc": false
}
'

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    app_id: 'app_1406',
    app_name: 'Purchase order extraction app (new version)',
    config_version: 'v1',
    app_label: ['purchase-order'],
    extract_fields: [
      {
        field_name: 'Order number',
        field_type: 'string',
        field_prompt: 'Extract the purchase order number.'
      },
      {
        field_name: 'Supplier name',
        field_type: 'string',
        field_prompt: 'Extract the supplier name.'
      }
    ],
    parse_mode: 'fast_vlm',
    enable_highlight: 1,
    enable_pdf_parse: true,
    pdf_pic_second_parsing: false,
    enable_stamp_recognition: true,
    enable_long_doc: false
  })
};

fetch('https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

response = requests.post(
    "https://adp-global.laiye.com/open/agentic_doc_processor/laiye/v1/app-manage/update",
    headers={"X-API-KEY": "YOUR_API_KEY"},
    json={
        "app_id": "app_1406",
        "extract_fields": [
            {"field_name": "Order number", "field_type": "string"}
        ],
        "parse_mode": "standard",
    },
    timeout=60,
)
response.raise_for_status()
result = response.json()
if result.get("code") not in ("success", 200, "200"):
    raise RuntimeError(result.get("message") or result.get("code"))

HttpResponse<String> response = Unirest.post("https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"app_id\": \"app_1406\",\n  \"app_name\": \"Purchase order extraction app (new version)\",\n  \"config_version\": \"v1\",\n  \"app_label\": [\n    \"purchase-order\"\n  ],\n  \"extract_fields\": [\n    {\n      \"field_name\": \"Order number\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the purchase order number.\"\n    },\n    {\n      \"field_name\": \"Supplier name\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the supplier name.\"\n    }\n  ],\n  \"parse_mode\": \"fast_vlm\",\n  \"enable_highlight\": 1,\n  \"enable_pdf_parse\": true,\n  \"pdf_pic_second_parsing\": false,\n  \"enable_stamp_recognition\": true,\n  \"enable_long_doc\": false\n}")
  .asString();

const url = 'https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update';
const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    app_id: 'app_1406',
    app_name: 'Purchase order extraction app (new version)',
    config_version: 'v1',
    app_label: ['purchase-order'],
    extract_fields: [
      {
        field_name: 'Order number',
        field_type: 'string',
        field_prompt: 'Extract the purchase order number.'
      },
      {
        field_name: 'Supplier name',
        field_type: 'string',
        field_prompt: 'Extract the supplier name.'
      }
    ],
    parse_mode: 'fast_vlm',
    enable_highlight: 1,
    enable_pdf_parse: true,
    pdf_pic_second_parsing: false,
    enable_stamp_recognition: true,
    enable_long_doc: false
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update"

	payload := strings.NewReader("{\n  \"app_id\": \"app_1406\",\n  \"app_name\": \"Purchase order extraction app (new version)\",\n  \"config_version\": \"v1\",\n  \"app_label\": [\n    \"purchase-order\"\n  ],\n  \"extract_fields\": [\n    {\n      \"field_name\": \"Order number\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the purchase order number.\"\n    },\n    {\n      \"field_name\": \"Supplier name\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the supplier name.\"\n    }\n  ],\n  \"parse_mode\": \"fast_vlm\",\n  \"enable_highlight\": 1,\n  \"enable_pdf_parse\": true,\n  \"pdf_pic_second_parsing\": false,\n  \"enable_stamp_recognition\": true,\n  \"enable_long_doc\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-API-KEY", "<api-key>");
request.AddJsonBody("{\n  \"app_id\": \"app_1406\",\n  \"app_name\": \"Purchase order extraction app (new version)\",\n  \"config_version\": \"v1\",\n  \"app_label\": [\n    \"purchase-order\"\n  ],\n  \"extract_fields\": [\n    {\n      \"field_name\": \"Order number\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the purchase order number.\"\n    },\n    {\n      \"field_name\": \"Supplier name\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the supplier name.\"\n    }\n  ],\n  \"parse_mode\": \"fast_vlm\",\n  \"enable_highlight\": 1,\n  \"enable_pdf_parse\": true,\n  \"pdf_pic_second_parsing\": false,\n  \"enable_stamp_recognition\": true,\n  \"enable_long_doc\": false\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'app_id' => 'app_1406',
    'app_name' => 'Purchase order extraction app (new version)',
    'config_version' => 'v1',
    'app_label' => [
        'purchase-order'
    ],
    'extract_fields' => [
        [
                'field_name' => 'Order number',
                'field_type' => 'string',
                'field_prompt' => 'Extract the purchase order number.'
        ],
        [
                'field_name' => 'Supplier name',
                'field_type' => 'string',
                'field_prompt' => 'Extract the supplier name.'
        ]
    ],
    'parse_mode' => 'fast_vlm',
    'enable_highlight' => 1,
    'enable_pdf_parse' => true,
    'pdf_pic_second_parsing' => false,
    'enable_stamp_recognition' => true,
    'enable_long_doc' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "code": "success",
  "message": "",
  "tips": null,
  "data": {
    "config_version": "v2"
  }
}

Application Management

Update extraction application

Update the name, labels, fields, and extraction configuration of an extraction application, and create a new configuration version. To update a high-speed custom extraction application, reuse this endpoint and pass the app_id of the high-speed application. The request body does not need ai_function. High-speed custom extraction applications do not support setting parse_mode, enable_highlight, enable_pdf_parse, pdf_pic_second_parsing, enable_stamp_recognition, or enable_long_doc. An HTTP 200 response can still represent a business failure, so callers must check both the HTTP status and the response code.

POST

open

agentic_doc_processor

{tenant_name}

app-manage

update

cURL

curl --request POST \
  --url https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "app_id": "app_1406",
  "app_name": "Purchase order extraction app (new version)",
  "config_version": "v1",
  "app_label": [
    "purchase-order"
  ],
  "extract_fields": [
    {
      "field_name": "Order number",
      "field_type": "string",
      "field_prompt": "Extract the purchase order number."
    },
    {
      "field_name": "Supplier name",
      "field_type": "string",
      "field_prompt": "Extract the supplier name."
    }
  ],
  "parse_mode": "fast_vlm",
  "enable_highlight": 1,
  "enable_pdf_parse": true,
  "pdf_pic_second_parsing": false,
  "enable_stamp_recognition": true,
  "enable_long_doc": false
}
'

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    app_id: 'app_1406',
    app_name: 'Purchase order extraction app (new version)',
    config_version: 'v1',
    app_label: ['purchase-order'],
    extract_fields: [
      {
        field_name: 'Order number',
        field_type: 'string',
        field_prompt: 'Extract the purchase order number.'
      },
      {
        field_name: 'Supplier name',
        field_type: 'string',
        field_prompt: 'Extract the supplier name.'
      }
    ],
    parse_mode: 'fast_vlm',
    enable_highlight: 1,
    enable_pdf_parse: true,
    pdf_pic_second_parsing: false,
    enable_stamp_recognition: true,
    enable_long_doc: false
  })
};

fetch('https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

response = requests.post(
    "https://adp-global.laiye.com/open/agentic_doc_processor/laiye/v1/app-manage/update",
    headers={"X-API-KEY": "YOUR_API_KEY"},
    json={
        "app_id": "app_1406",
        "extract_fields": [
            {"field_name": "Order number", "field_type": "string"}
        ],
        "parse_mode": "standard",
    },
    timeout=60,
)
response.raise_for_status()
result = response.json()
if result.get("code") not in ("success", 200, "200"):
    raise RuntimeError(result.get("message") or result.get("code"))

HttpResponse<String> response = Unirest.post("https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"app_id\": \"app_1406\",\n  \"app_name\": \"Purchase order extraction app (new version)\",\n  \"config_version\": \"v1\",\n  \"app_label\": [\n    \"purchase-order\"\n  ],\n  \"extract_fields\": [\n    {\n      \"field_name\": \"Order number\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the purchase order number.\"\n    },\n    {\n      \"field_name\": \"Supplier name\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the supplier name.\"\n    }\n  ],\n  \"parse_mode\": \"fast_vlm\",\n  \"enable_highlight\": 1,\n  \"enable_pdf_parse\": true,\n  \"pdf_pic_second_parsing\": false,\n  \"enable_stamp_recognition\": true,\n  \"enable_long_doc\": false\n}")
  .asString();

const url = 'https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update';
const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    app_id: 'app_1406',
    app_name: 'Purchase order extraction app (new version)',
    config_version: 'v1',
    app_label: ['purchase-order'],
    extract_fields: [
      {
        field_name: 'Order number',
        field_type: 'string',
        field_prompt: 'Extract the purchase order number.'
      },
      {
        field_name: 'Supplier name',
        field_type: 'string',
        field_prompt: 'Extract the supplier name.'
      }
    ],
    parse_mode: 'fast_vlm',
    enable_highlight: 1,
    enable_pdf_parse: true,
    pdf_pic_second_parsing: false,
    enable_stamp_recognition: true,
    enable_long_doc: false
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update"

	payload := strings.NewReader("{\n  \"app_id\": \"app_1406\",\n  \"app_name\": \"Purchase order extraction app (new version)\",\n  \"config_version\": \"v1\",\n  \"app_label\": [\n    \"purchase-order\"\n  ],\n  \"extract_fields\": [\n    {\n      \"field_name\": \"Order number\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the purchase order number.\"\n    },\n    {\n      \"field_name\": \"Supplier name\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the supplier name.\"\n    }\n  ],\n  \"parse_mode\": \"fast_vlm\",\n  \"enable_highlight\": 1,\n  \"enable_pdf_parse\": true,\n  \"pdf_pic_second_parsing\": false,\n  \"enable_stamp_recognition\": true,\n  \"enable_long_doc\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-API-KEY", "<api-key>");
request.AddJsonBody("{\n  \"app_id\": \"app_1406\",\n  \"app_name\": \"Purchase order extraction app (new version)\",\n  \"config_version\": \"v1\",\n  \"app_label\": [\n    \"purchase-order\"\n  ],\n  \"extract_fields\": [\n    {\n      \"field_name\": \"Order number\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the purchase order number.\"\n    },\n    {\n      \"field_name\": \"Supplier name\",\n      \"field_type\": \"string\",\n      \"field_prompt\": \"Extract the supplier name.\"\n    }\n  ],\n  \"parse_mode\": \"fast_vlm\",\n  \"enable_highlight\": 1,\n  \"enable_pdf_parse\": true,\n  \"pdf_pic_second_parsing\": false,\n  \"enable_stamp_recognition\": true,\n  \"enable_long_doc\": false\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://adp-global.laiye.com/open/agentic_doc_processor/{tenant_name}/v1/app-manage/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'app_id' => 'app_1406',
    'app_name' => 'Purchase order extraction app (new version)',
    'config_version' => 'v1',
    'app_label' => [
        'purchase-order'
    ],
    'extract_fields' => [
        [
                'field_name' => 'Order number',
                'field_type' => 'string',
                'field_prompt' => 'Extract the purchase order number.'
        ],
        [
                'field_name' => 'Supplier name',
                'field_type' => 'string',
                'field_prompt' => 'Extract the supplier name.'
        ]
    ],
    'parse_mode' => 'fast_vlm',
    'enable_highlight' => 1,
    'enable_pdf_parse' => true,
    'pdf_pic_second_parsing' => false,
    'enable_stamp_recognition' => true,
    'enable_long_doc' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "code": "success",
  "message": "",
  "tips": null,
  "data": {
    "config_version": "v2"
  }
}

Authorizations

X-API-KEY

string

header

required

Production API Key. You can find it under My API in the ADP platform. Make sure the API Key is active and belongs to the production environment.

Path Parameters

tenant_name

string

default:laiye

required

Tenant name. Default: laiye.

Body

application/json

Update standard custom extraction application
Update high-speed extraction application

app_id

string

required

Application ID.

extract_fields

object[]

required

Extraction field configuration list. Up to 20 fields.

Maximum array length: 20

Show child attributes

parse_mode

enum<string>

required

Parsing mode. Required for standard custom extraction applications. High-speed custom extraction applications do not support setting this parameter. Available parsing modes are:

standard: Standard parsing for clear digital documents, balancing speed and accuracy.
advance: Enhanced parsing 1.0 for documents with stamps, signatures, multiple tables, or moderately complex layouts.
agentic: Smart parsing that combines standard and enhanced parsing and performs secondary parsing when conditions are met.
fast_vlm: Enhanced parsing 2.0 for complex layouts, scanned documents, and documents with multiple tables, improving parsing stability.
agentic_v2: Smart parsing 2.0 with two-stage layout analysis and content recognition for documents with complex layouts, tables, and formulas.

Available options:

standard,

advance,

agentic,

fast_vlm,

agentic_v2

app_name

string

Application name. If omitted or passed as an empty string, the name is not updated.

config_version

string

Current configuration version. The update is saved as a new version.

app_label

string[]

Application labels. Up to 5 labels.

Maximum array length: 5

enable_highlight

enum<integer>

default:1

Whether to include source locations. Pass 1 to enable or 0 to disable. Supported by standard, agentic, fast_vlm, and agentic_v2. Not supported by advance.

Available options:

0,

1

enable_pdf_parse

boolean

default:false

Whether to prefer PDF text extraction. Use this for digital PDFs with selectable text to improve processing speed and text stability.

pdf_pic_second_parsing

boolean

default:false

When PDF text extraction is enabled, whether to run secondary parsing on images inside the PDF.

enable_stamp_recognition

boolean

default:false

Whether to enable stamp recognition. The service attempts to recognize stamp information in the document. Stamp recognition capability must be enabled.

enable_field_value_translation

boolean

default:false

Whether to enable extracted value translation. Disabled by default.

enable_long_doc

boolean

default:false

Whether to enable long document support. Standard custom extraction applications support this parameter. High-speed custom extraction applications do not support setting this parameter.

long_doc_config

object[]

Long document configuration. Used only when enable_long_doc is true.

Maximum array length: 5

Show child attributes

Response

Extraction application update result.

code

Business code. A successful response is usually success or 200.

message

string

Response message.

tips

string | null

Details. Defaults to null.

data

object

Show child attributes

Product docs

Other docs

Update extraction application

Authorizations

Path Parameters

Body

Response