Skip to main content
PUT
/
import-config
/
{importConfigId}
Update import config
curl --request PUT \
  --url https://apiweb.mile.app/api/v3/import-config/{importConfigId}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Delivery Order Import - Flow A (Updated)",
  "description": "Updated column mapping preset",
  "collection": "task",
  "referenceType": "flow",
  "referenceId": "66a988d53ae08a7ab52867c2",
  "fields": [
    {
      "id": "orderNumber",
      "headerColumn": "Order Number"
    },
    {
      "id": "customerName",
      "headerColumn": "Customer Name"
    },
    {
      "id": "address",
      "headerColumn": "Delivery Address"
    },
    {
      "id": "billItem",
      "sheet": "Bill Items",
      "fields": [
        {
          "id": "name",
          "headerColumn": "Item Name"
        },
        {
          "id": "qty",
          "headerColumn": "Quantity"
        },
        {
          "id": "unitPrice",
          "headerColumn": "Unit Price"
        }
      ]
    }
  ]
}
'
{
  "status": true,
  "code": 200,
  "message": "Import Config has been updated successfully.",
  "data": {
    "_id": "67b5a1234567890abcdef001",
    "name": "Delivery Order Import - Flow A (Updated)",
    "description": "Updated column mapping preset",
    "collection": "task",
    "referenceType": "flow",
    "referenceId": "66a988d53ae08a7ab52867c2",
    "fields": [
      {
        "id": "orderNumber",
        "headerColumn": "Order Number"
      },
      {
        "id": "customerName",
        "headerColumn": "Customer Name"
      },
      {
        "id": "address",
        "headerColumn": "Delivery Address"
      },
      {
        "id": "billItem",
        "sheet": "Bill Items",
        "fields": [
          {
            "id": "name",
            "headerColumn": "Item Name"
          },
          {
            "id": "qty",
            "headerColumn": "Quantity"
          },
          {
            "id": "unitPrice",
            "headerColumn": "Unit Price"
          }
        ]
      }
    ],
    "organizationId": "66791b2bf001a712b77b3622",
    "updatedTime": "2026-02-19T09:15:00.000000Z",
    "createdTime": "2026-02-19T08:30:00.000000Z"
  }
}

Authorizations

​
Authorization
string
header
required

Use a valid Bearer token to authenticate.

Path Parameters

​
importConfigId
string
required

Unique identifier for the import config that generated by system. Example: 67b5a1234567890abcdef001

Body

application/json
​
name
string
required

The name of the import config. Maximum 200 characters. Example: Delivery Order Import - Flow A

​
collection
string
required

The collection type for the import. Example: task

​
referenceType
string
required

The type of reference for this config. Example: flow

​
referenceId
string
required

The ID of the referenced resource (e.g., flow ID). Use Flow /flows API to get the list of flow IDs. Example: 66a988d53ae08a7ab52867c2

​
fields
object[]
required

Array of field mapping objects. Each object maps a flow field to an Excel header column. For complex components (bill, list, subpage), include sheet and nested fields.

​
description
string

Response

Success

​
status
boolean

Status of response.

​
code
integer

Code of response.

​
message
string

Message of API response.

​
data
object

Detail of updated import config object.