Skip to main content

Update Incoterm

PUT 
/api/incoterms/:incoterm

Manage the Incoterms 2020 reference table. Standard ICC rows carry structured trade-term metadata used to drive buyer/seller responsibility panels on purchase and sales orders.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Fields:

  • code (required, string, max 10, unique) — e.g. DAP, FOB. Locked for standard ICC rows.
  • name (string) — human label, e.g. Delivered at Place.
  • description (string)
  • transport_mode (enum) — any | sea_inland.
  • family (enum) — E | F | C | D (ICC term family).
  • seller_pays_main_carriage (boolean)
  • export_cleared_by (enum) — seller | buyer.
  • import_cleared_by (enum) — seller | buyer.
  • seller_insurance (enum) — none | clause_a | clause_c.
  • risk_transfer_point (string) — plain-English point where risk passes.
  • sort_order (integer)
  • is_deprecated (boolean) — flags retired rules (e.g. DAT).

is_standard is server-maintained and NOT accepted in the request body.

Authentication: Requires Bearer token. Permission: incoterms.create / incoterms.update.

Request​

Responses​

OK

Response Headers
    Content-Type