MCP documentation | MCP docs for agents
ark_update_dispatch
ark.update_dispatch
Update an existing ARK dispatch, or update only carrier pay on an inactive historical dispatch without restarting carrier or tracking workflows.
- Availability
- Expanded preview
- Scopes
loads:dispatch- ARK permissions
canAssignLoads- Team visibility
- Required and enforced
- Approval policy
ask_before_send- 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
loadIdstringrequiredVisible ARK load ID to dispatch.
format: uuid
carrierIdstringrequiredActive organization carrier ID to book on the load.
format: uuid
dispatcherobject | nullrequiredCurrent dispatcher details. May be null only for inactive historical carrier-pay-only updates.
driverobject | nullrequiredCurrent driver details, or null to explicitly clear the driver.
truckNumberstring | nullrequiredmax length: 100
trailerNumberstring | nullrequiredmax length: 100
highwayVehicleSelectionTokenstring | nullOpaque Highway vehicle-selection proof issued by ARK.
min length: 1; max length: 10000
dispatchPayarray<object>Optional replacement dispatch pay items. Omit to leave dispatch pay unchanged.
max items: 100
dispatchIdstringrequiredVisible ARK dispatch ID to update.
format: uuid
carrierCurrencystringrequiredCurrent carrier currency to preserve or explicitly change.
one of: USD, CAD, MXN
historicalPayOnlybooleanUpdate only carrier pay on an inactive historical dispatch. Carrier, contacts, equipment, currency, tracking, RateCon, and Highway state remain unchanged.
default: false
updateTrackingbooleanExplicitly update active tracking provider data after the dispatch changes.
default: false
queueQuickBooksSyncbooleanExplicitly queue a QuickBooks carrier bill update when a mapped bill is updateable.
default: false
Result
The tool returns the canonical ark.update_dispatch 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.