Update imported stop tasks
MCP tool: update_imported_stop_tasks. See AI Assistants (MCP).
Updates the tasks 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 tasks on the stop is replaced with the task
templates provided in the request body. Task and item IDs are always
regenerated by the server, and any existing completion state, input, or
timestamps are cleared, since only the driver (via the driver app) can mark
a task or item complete or provide input. The ID can be the EasyRoutes id
returned on import or the client-provided clientStopId. Note that this
only updates the imported stop record; if the stop has already been added
to a route, use update_route_stop_tasks to update its tasks on that
route.
Authorization
bearerAuth Access token from /authenticate
In: header
Path Parameters
The ID of the imported stop to update tasks 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.
A template for creating tasks at a stop. Task templates may have one or more
items for CHECKBOXES or RADIO_BUTTONS. Imported stops may have task
templates that are used to create tasks when the stop is added to a route.
Response Body
application/json
application/json
curl -X PUT "https://example.com/stops/imports/ist-123e4567-e89b-12d3-a456-426614174000/tasks" \ -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" } ]}