---
title: "Partially update a layer"
method: PATCH
path: "/layers/{id}"
tags: ["Locations"]
---

# Partially update a layer

`PATCH /layers/{id}`

Update specific fields of a geographic layer without affecting other configuration. Commonly used for updating metadata or modifying the location collection. 

**Common Use Cases:** 
- Add or remove locations from collection 
- Update layer title or description 
- Modify sharing permissions 
- Change layer type classification

## Request body

- Layer
  - `id` integer
  - `title` string, nullable — Descriptive title for the layer (e.g., 'Emergency Response Zones', 'Service Areas', 'County Boundaries')
  - `description` string, nullable — Detailed description of the layer's purpose, contents, and intended use
  - `locations` object — Array of location IDs included in this layer collection
  - `available_to` object — JSON object specifying which organizations or users have access to this layer
  - `type` integer, 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 `200`

OK

- Layer
  - `id` integer
  - `title` string, nullable — Descriptive title for the layer (e.g., 'Emergency Response Zones', 'Service Areas', 'County Boundaries')
  - `description` string, nullable — Detailed description of the layer's purpose, contents, and intended use
  - `locations` object — Array of location IDs included in this layer collection
  - `available_to` object — JSON object specifying which organizations or users have access to this layer
  - `type` integer, 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)

## Other responses

- `400` — Validation error - check provided fields
- `403` — Permission denied - cannot modify this layer
- `404` — Layer not found

---

[API](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api.md) · [All operations](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crisiscleanup/crisiscleanup-api/revisions/3fa73d4b2895/schema)