EasyRoutes API

Update imported stop location

PATCH
/stops/imports/{id}/location

Updates the address and/or coordinates for an imported stop by ID. The ID can be the EasyRoutes id returned on import or the client-provided clientStopId. This is a partial update: provide the fields to change in location and list their paths in updateMask, which must contain at least one of address or coordinates. This only updates the imported stop record itself; if the stop has already been added to one or more routes, use UpdateRouteStopLocation to update those route-stop copies. The response returns the updated ImportedStop.

Authorization

bearerAuth
AuthorizationBearer <token>

Access token from /authenticate

In: header

Path Parameters

id*string

The ID of the imported stop to update. You provide the EasyRoutes id returned on import or the client-provided clientStopId.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PATCH "https://example.com/stops/imports/ist-123e4567-e89b-12d3-a456-426614174000/location" \  -H "Content-Type: application/json" \  -d '{    "location": {},    "updateMask": "string"  }'
{  "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"    }  ],  "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."}
{  "code": 0,  "message": "string",  "details": [    {      "@type": "string"    }  ]}