Locations

Update a layer

Update all fields of an existing geographic layer. Useful for reorganizing location collections, updating descriptions, or modifying access permissions.

Updatable Fields:

  • Title and description
  • Location array (add/remove locations)
  • Sharing level and access permissions
  • Layer type classification

Permission Requirements:

  • Layer created by user's organization or affiliates
  • OR user has explicit access via available_to settings
put/layers/{id}

Request body

idinteger
titlestring nullable

Descriptive title for the layer (e.g., 'Emergency Response Zones', 'Service Areas', 'County Boundaries')

descriptionstring nullable

Detailed description of the layer's purpose, contents, and intended use

locationsobject

Array of location IDs included in this layer collection

available_toobject

JSON object specifying which organizations or users have access to this layer

typeinteger nullable

Optional location type for categorizing this layer (references location type)

shared'shared' | 'public' | 'private' | 'hidden' nullable

Basic sharing level: 'public' (all users), 'shared' (organization + affiliates), 'private' (organization only)

Response

OK

idinteger
titlestring nullable

Descriptive title for the layer (e.g., 'Emergency Response Zones', 'Service Areas', 'County Boundaries')

descriptionstring nullable

Detailed description of the layer's purpose, contents, and intended use

locationsobject

Array of location IDs included in this layer collection

available_toobject

JSON object specifying which organizations or users have access to this layer

typeinteger nullable

Optional location type for categorizing this layer (references location type)

shared'shared' | 'public' | 'private' | 'hidden' nullable

Basic sharing level: 'public' (all users), 'shared' (organization + affiliates), 'private' (organization only)

Changes

No recorded changes to this endpoint across all 1 revision of this API.