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
- No
- Rate limit
- OAuth MCP credential and organization budgets
Input
loadIdstringrequiredVisible ARK load ID.
format: uuid
customerIdstring | nullCustomer ID to assign to the load, or null to clear.
format: uuid
teamIdstringVisible team ID to assign to the load.
format: uuid
brokerIdstring | nullformat: uuid
customerServiceRepIdstring | nullformat: uuid
temperaturenumber | nullinternalCommentsstring | nullmax length: 5000
externalCommentsstring | nullmax length: 5000
hotCommentsstring | nullmax length: 5000
pickupNumberstring | nullmax length: 100
purchaseOrderNumberstring | nullmax length: 100
billOfLadingstring | nullmax length: 100
productstring | nullmax length: 200
valuenumber | nulldescriptionstring | nullmax length: 5000
sizestring | nullmax length: 100
trailerstring | nullmax length: 100
weightnumber | nullweightUnitstringone of: lbs, kg
lengthnumber | nullwidthnumber | nullheightnumber | nullnumberOfPiecesinteger | nullmin: 0
hazmatbooleandocHighbooleanstackablebooleantsabooleanteamDriverRequiredbooleanmilesnumber | nullmin: 0
maximumBuyAmountnumber | nullMaximum carrier buy amount for load-board and market-intelligence workflows.
min: 0
customerCurrencystringone of: USD, CAD, MXN
carrierCurrencystringone of: USD, CAD, MXN
customerPayarray<object>Replacement customer-pay lines. Omit to leave customer pay unchanged.
max items: 100
stopsarray<object>Replacement stop list. Omit to leave stops unchanged.
min items: 2; max items: 50
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.