Trigger Dataset to Read Data File and Update

GET

/public-api/data-source/refresh-with-file

API Description

Core steps:

Refer to the instructions below to copy the data file to the specified server location

Call the API to update the specific dataset.
Special notes:
① This is a limited-time free API. Additional charges may apply in the future.
② The specific data file needs to be stored in the designated server location.

Non-minio environment: /home/guandata/data/guandata-store/upload_dataset/{dsid}

Minio environment: /home/guandata/data/minio/guandata-store/upload_dataset/{dsid}

③ File format requirements:

Snappy compression, written as file groups, avoid single large files

Escape the following special characters in field names: ' ', ',', ';', '{', '}', '(', ')', '\n', '\t', '=', '.'. Use '%' as the escape character, so '%' itself also needs escaping.

④ Similar to /public-api/data-source/:dsId/refresh-with-file, but that uses Personal Token while this uses Application Token.

Request

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/public-api/data-source/refresh-with-file?token&dsId&overwrite&fileType&preClean&subDir'

Responses

🟢200Success

application/json

Body

Example

{
    "result": "ok",
    "response": {
        "taskId": "1c30f9f0-6d7f-11ee-8cc2-bd5513e186d5",
        "status": "Submitted",
        "result": "Processing"
    }
}

Modified at 2026-07-15 06:40:16

Update Dataset Field Comments

Query Dataset Update Result by TaskID