---
title: "Generate a palette"
method: GET
path: "/api/v1/generate-palette"
---

# Generate a palette

`GET /api/v1/generate-palette`

## Request

- Base URL: `https://pickshade.com`
- URL: `https://pickshade.com/api/v1/generate-palette`
- Auth: none declared

Generate a harmonious palette in OKLCH. Keep colors you already have, pick a style (auto, analogous, complementary, triadic, monochromatic, pastel, vivid, muted, dark) and pass a seed to get the same palette every time.

## Query parameters

- `keep` string[]: Colors that must stay in the palette, in order
- `mode` 'auto' | 'analogous' | 'complementary' | 'triadic' | 'monochromatic' | 'pastel' | 'vivid' | 'muted' | 'dark'
- `size` integer
- `seed` string: Any text. The same seed gives the same palette

## Response `200`

Result

## Other responses

- `400`: Invalid input
- `429`: Too many requests. See the Retry-After header

---

[API](https://skmtc.dev/pickshade/apis/pickshade-color-api.md) · [All operations](https://skmtc.dev/pickshade/apis/pickshade-color-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickshade/apis/pickshade-color-api/revisions/00f0b7c55ea7?raw)