Update imported stop items
MCP tool: update_imported_stop_items. See AI Assistants (MCP).
Updates the items on an existing imported stop by ID, without needing to
re-send the full stop payload via import_stops. This is a full
replacement: the entire list of items on the stop is replaced with the
items provided in the request body. The ID can be the EasyRoutes id
returned on import or the client-provided clientStopId. Items are
validated to ensure they meet the following constraints: maximum 499 items
per stop, item names up to 1500 characters, quantities up to 100,000, and
weight up to 1,000,000,000 grams. Note that this only updates the imported
stop record; if the stop has already been added to a route, use
update_route_stop_items to update its items on that route.
Authorization
bearerAuth Access token from /authenticate
In: header
Path Parameters
The ID of the imported stop to update items for. You provide the
EasyRoutes id returned on import or the client-provided clientStopId.
Header Parameters
A unique key for safely retrying this operation. For more information read our guide.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
An item to be delivered at a stop.
Response Body
application/json
application/json
curl -X PUT "https://example.com/stops/imports/ist-123e4567-e89b-12d3-a456-426614174000/items" \ -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \ -H "Content-Type: application/json" \ -d '[ {} ]'{ "id": "ist-123e4567-e89b-12d3-a456-426614174000", "clientStopId": "test-order-1234", "address": { "address1": "123 Main St", "address2": "Apt 3B", "city": "New York", "provinceCode": "NY", "countryCode": "US", "zip": "10001" }, "contact": { "firstName": "John", "lastName": "Doe", "company": "Roundtrip Systems Inc", "phone": "+14265551000", "email": "john.doe@roundtrip.ai" }, "coordinates": { "latitude": 40.7128, "longitude": -74.006 }, "items": [ { "name": "Bananas", "quantity": 5, "grams": 500, "sku": "BANANA-001", "source": "SHOPIFY_ORDER", "shopifyLineItemId": "14512345678901", "shopifyFulfillmentId": "5812345678901", "shopifyVariantId": "44512345678901", "shopifyProductId": "8812345678901" } ], "note": "Leave at door.", "duration": "300s", "priority": 5, "orderName": "#1234", "importedAt": "2026-03-28T10:00:00Z", "timeWindows": [ { "start": { "hours": 9 }, "end": { "hours": 17 } } ], "deliveryDate": { "year": 2025, "month": 12, "day": 16 }, "attributes": [ { "key": "color", "value": "blue" } ], "tags": [ "foo", "bar" ], "tasks": [ { "title": "Delivery checklist", "type": "CHECKBOXES", "items": [ { "title": "Pick up package" } ], "requiredToMarkStopAsDelivered": true, "requiredToMarkStopAsAttempted": true } ], "type": "DELIVERY", "customSignatureDisclosure": "I acknowledge that I have received this delivery.", "orderReferenceUrl": "https://orders.example.com/orders/148977776"}{ "code": 0, "message": "string", "details": [ { "@type": "string" } ]}