[beta] Update a place

patch

https://api.samsara.com/places

Updates a place. Query parameter placeId (Samsara id) is required. Optional externalId (key:value) is reserved for a future release and must not be combined with placeId. Only fields present in the JSON body are changed; omit a field to leave it unchanged.

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

To use this endpoint, select Write Places under the Places 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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

placeId

int64

required

Samsara place id to update (required). Do not send externalId in the same request.

externalId

string

External id token in key:value form (e.g. crmId:warehouse-east). Mutually exclusive with placeId. Batch lookup by external id is not implemented for this endpoint yet; callers should use placeId until supported.

Body Params

Partial update for a place.

address

string

Single-line address string.

geofence

array of objects

Polygon vertices; at least three when switching to polygon mode.

geofence

hubLocations

object

Partial hub location changes for a place. When present on PATCH, applies upserts and removals; omitted leaves hub rows unchanged.

latitude

double

Center latitude when switching to or editing a circle geofence.

longitude

double

Center longitude when switching to or editing a circle geofence.

name

string

Place name.

navigation

object

Navigation metadata for create.

notes

string

Notes.

placeTypes

array of strings

Unsupported on patch; when provided this API returns InvalidArgument.

placeTypes

radiusMeters

integer

≥ 1

Circle radius in meters; use with latitude and longitude.

200OK response.

401Unauthorized response.

404Not Found response.

405Method Not Allowed response.

429Too Many Requests response.

500Internal Server Error response.

501Not Implemented response.

502Bad Gateway response.

503Service Unavailable response.

504Gateway Timeout response.

defaultBad Request response.