---
title: "Update a custom color palette"
method: PUT
path: "/api/v1/color-palettes/{id}"
tags: ["Color Palettes"]
---

# Update a custom color palette

`PUT /api/v1/color-palettes/{id}`

## Request

- Base URL: `https://omniapp.co` (the document declares no server; this is the origin it was published from)
- URL: `https://omniapp.co/api/v1/color-palettes/{id}`
- Auth: HTTP bearer

Updates a custom chart color palette. Omitted fields keep their current values. Charts using the palette pick up the new colors. Requires the Manage Config permission.

## Path parameters

- `id` string, uuid, required: Palette ID

## Request body

- ColorPalettesUpdateBody
  - `colors` string[]: Ordered hex colors. Discrete palettes are used in order; continuous palettes interpolate between them.
  - `name` string: Palette name, unique per type within the organization
  - `type` 'discrete' | 'continuous': 'discrete' palettes color categories; 'continuous' palettes define a gradient for numeric scales

## Response `200`

Color palette updated

- ColorPalettesUpdateResponse
  - `colors` string[], required: Ordered colors as stored, usually hex values
  - `created_at` string, date-time, required: When the palette was created
  - `id` string, uuid, required: Palette ID. Visualizations reference the palette by this value.
  - `name` string, required: Palette name
  - `type` 'discrete' | 'continuous', required: 'discrete' palettes color categories; 'continuous' palettes define a gradient for numeric scales
  - `updated_at` string, date-time, required: When the palette was last updated

## Other responses

- `400`: Invalid request body or palette ID
- `401`: Authentication required
- `403`: Requires the Manage Config permission
- `404`: Color palette not found
- `409`: Another palette already has this name and type, or the palette is the organization's default and cannot change type

## Changes

- **2026-09-15** `febf0a61f153`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omniapp/apis/omni-api/changes/api/v1/color-palettes/:id/put.md)

---

[API](https://skmtc.dev/omniapp/apis/omni-api.md) - [All operations](https://skmtc.dev/omniapp/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omniapp/apis/omni-api/revisions/76b40ebc2292?raw)