Update a location

Update existing location by ID.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Routes under the Driver Workflow category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

PATCH /hub/location/{id}

Update a location

cURL

curl --request PATCH \
  --url https://api.samsara.com/hub/location/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "address": "123 Industrial Blvd, Los Angeles, CA 90210, US",
    "customerLocationId": "LOC-123",
    "driverInstructions": "sample instructions",
    "isDepot": false,
    "latitude": 34.0522,
    "longitude": -118.2437,
    "name": "Customer ABC Warehouse",
    "plannerNotes": "sample note",
    "serviceTimeSeconds": 1800,
    "serviceWindows": [
      {
        "daysOfWeek": [
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday"
        ],
        "endTime": "17:00:00",
        "startTime": "08:00:00"
      }
    ],
    "skillsRequired": [
      "650e8400-e29b-41d4-a716-446655440001"
    ]
  }
}
'

200

{
  "data": {
    "address": "123 Industrial Blvd, Los Angeles, CA 90210, US",
    "createdAt": "2024-01-15T10:30:00Z",
    "customerLocationId": "LOC-123",
    "driverInstructions": "sample instructions",
    "hubId": "550e8400-e29b-41d4-a716-446655440000",
    "id": "750e8400-e29b-41d4-a716-446655440002",
    "isDepot": false,
    "latitude": 34.0522,
    "longitude": -118.2437,
    "name": "Customer ABC Warehouse",
    "plannerNotes": "sample note",
    "serviceTimeSeconds": 1800,
    "serviceWindows": [
      {
        "daysOfWeek": [
          "monday",
          "monday",
          "monday",
          "monday"
        ],
        "endTime": "17:00:00",
        "startTime": "08:00:00"
      }
    ],
    "skillsRequired": [
      {
        "id": "650e8400-e29b-41d4-a716-446655440001",
        "name": "Heavy Lifting"
      }
    ],
    "updatedAt": "2024-01-15T10:30:00Z"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

The unique Samsara ID of the hub location to update

Body

application/json

Request body for updating a hub location

data · object · required

Request body for updating a hub location

Show child attributes

Response

200

application/json

OK response.

data · object · required

Updated hub location object

Show child attributes