---
title: "Toggle visibility, set opacity, rename, regroup, or replace render config of a map layer."
method: POST
path: "/v1/op/map_layers.update"
tags: ["kernel-ops"]
---

# Toggle visibility, set opacity, rename, regroup, or replace render config of a map layer.

`POST /v1/op/map_layers.update`

## Headers

- `x-api-key` string, nullable

## Request body

- MapLayerUpdateInput
  - `id` string, required
  - `name` string, nullable
  - `visible` boolean, nullable
  - `opacity` number, nullable
  - `z_order` integer, nullable
  - `group_id` string, nullable
  - `render_config` object, nullable
  - `source` object, nullable
  - `render_3d` boolean, nullable

## Response `200`

Successful Response

- MapLayer
  - `id` string, required
  - `project_id` string, required
  - `name` string, required
  - `kind` string, required
  - `source` object
  - `render_config` object, nullable
  - `visible` boolean
  - `opacity` number
  - `z_order` integer
  - `group_id` string, nullable
  - `access_model` string, nullable
  - `render_3d` boolean
  - `created_by` string, nullable
  - `created_at` string, nullable
  - `updated_at` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/geopera/apis/geopera-data-platform.md) · [All operations](https://skmtc.dev/geopera/apis/geopera-data-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geopera/geopera-data-platform/revisions/cb0130b2a40a/schema)