MCP documentation | MCP docs for agents
ark_update_load_details
ark.update_load_details
Update a visible ARK load revision, including customer, team, reps, commodity, dimensions, currencies, customer-pay lines, and optional full stop replacement.
- Availability
- Expanded preview
- Scopes
loads:write- ARK permissions
canEditLoad- Team visibility
- Required and enforced
- Approval policy
ask_before_write- ARK approval request
- Required before execution
- Idempotency
- Required for external execution
- Read-only
- No
- Destructive
- No
- External side effect
- Yes
- Rate limit
- OAuth MCP credential and organization budgets
Input
loadIdstringrequiredformat: uuid
customerIdstring | nullteamIdstringformat: uuid
brokerIdstring | nullcustomerServiceRepIdstring | nulltemperaturenumber | nulltemperatureMinnumber | nulltemperatureMaxnumber | nullinternalCommentsstring | nullexternalCommentsstring | nullhotCommentsstring | nullpickupNumberstring | nullpurchaseOrderNumberstring | nullbillOfLadingstring | nullproductstring | nullvaluenumber | nulldescriptionstring | nullsizestring | nulltrailerstring | nullweightnumber | nullweightUnitstringone of: lbs, kg
lengthnumber | nullwidthnumber | nullheightnumber | nullnumberOfPiecesinteger | nullhazmatbooleandocHighbooleanstackablebooleantsabooleanteamDriverRequiredbooleanmilesnumber | nullmaximumBuyAmountnumber | nullcustomerCurrencystringone of: USD, CAD, MXN
carrierCurrencystringone of: USD, CAD, MXN
customerPayarray<object>max items: 100
stopsarray<object>min items: 2; max items: 50
mutationIdstringmin length: 8; max length: 200
scheduleChangesarray<object>max items: 100
vendorExpenseRebillsarray<object>Pending Vendor Expense rebill edits committed with the same Save. Each entry updates the existing expense and its linked customer charge in one transaction.
max items: 100
billingReviewobjectExplicit acceptance of a billed-invoice mismatch shown during review. Required when the save would resolve a discrepancy between billing and the load charges.
Result
The tool returns the canonical ark.update_load_details operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.