Skip to content
POST AI agent ready /v1/color/palette

Color Palette API - Free Palette Generator

Create a harmonious color palette based on color theory. Choose from complementary, analogous, triadic, tetradic, or monochromatic schemes. Each swatch includes HEX, RGB, and HSL values.

Parameters

stringrequired

The base color to build the palette from.

string

The type of color harmony to generate.

Code examples

curl -X POST https://api.botoi.com/v1/color/palette \
  -H "Content-Type: application/json" \
  -d '{"color":"#3EC997","type":"complementary"}'

When to use this API

Dynamic theme generation

Generate an entire UI color scheme from a single brand color so users can customize their workspace with a one-click theme picker.

Data visualization palettes

Create a triadic or analogous palette from a base color to produce distinct but visually cohesive chart colors.

Frequently asked questions

What is the default palette type?
If you omit the type parameter, the API returns a complementary palette (the base color plus its color-wheel opposite).
How many colors are in each palette type?
Complementary returns 2, analogous returns 3, triadic returns 3, tetradic returns 4, and monochromatic returns 5 shades.
Can I get more than the default number of swatches?
The number of swatches is fixed by the harmony type. For more granularity, use the monochromatic type, which returns 5 lightness variations.
Does this work with dark colors?
Yes. The algorithm rotates hue on the color wheel, so it works with any lightness or saturation value.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.