---
title: "Update visualization metadata"
method: PUT
path: "/v0/aois/{aoi_id}/visualizations/{visualization_id}/metadata"
tags: ["Visualizations"]
---

# Update visualization metadata

`PUT /v0/aois/{aoi_id}/visualizations/{visualization_id}/metadata`

Updates the visualization metadata legend for a specific mode (dynamic or theoretical). Only the specified mode is updated; the other mode is preserved.

## Path parameters

- `aoi_id` string, required
- `visualization_id` string, required

## Request body

- AtlasVisualizationMetadataUpdateRequest
  - `visualization_mode` 'dynamic' | 'theoretical', required
  - `legend` object, required — Legend breakpoints per date. For dynamic mode, values can be null (auto-computed)
  - `dynamic_bins` integer — Number of equal-interval bins for dynamic mode (1-15). Required when visualization_mode is dynamic

## Response `200`

OK

- AtlasVisualizationMetadata
  - `legend` object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/pixxel/apis/stargate.md) · [All operations](https://skmtc.net/pixxel/apis/stargate/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pixxel/stargate/versions/b501e2ca5a9d/schema)