Locations

Create a new geographic layer

Create a new layer containing a collection of related locations. Layers are useful for organizing locations into logical groups for mapping, analysis, or administrative purposes.

Layer Configuration:

  • locations: Array of location IDs to include
  • type: Optional location type for categorization
  • shared: Access level (public, shared, private)
  • available_to: Specific organizations with access

Access Control:

  • Creator organization has full management access
  • Sharing settings control broader access
  • Available_to field enables granular permissions
post/layers

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

Created

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