API Documentation

Developer Documentation

Everything you need to integrate ColorGenius API into your applications. Get started in minutes with our comprehensive guides and examples.

Available Endpoints

POST

/v1/palettes

🎨 Generate Enhanced Color Palette

Generate a color palette with MASSIVE value - includes gradients, shadows, accessibility, animations & more!

Parameters

type

string

default: random

Palette type: random, complementary, analogous, triadic, monochromatic

count

number

default: 5

Number of colors (1-20)

format

string

default: hex

Output format: hex, rgb, hsl, tailwind

baseColor

string

Base color for palette generation

name

string

Name for saving the palette

save

boolean

Save palette to your account

includeMetadata

boolean

Include Tailwind config and CSS variables

includeGradients

boolean

🌈 Include beautiful gradients (linear, radial, conic)

includeShadows

boolean

🌟 Include professional shadow variations

includeAccessibility

boolean

♿ Include WCAG compliance analysis

includeHarmonies

boolean

🎯 Include color theory harmonies

includeThemeVariations

boolean

🎨 Include 6 theme variations (light, dark, vibrant, muted, pastel, neon)

includeAnimations

boolean

✨ Include animated CSS effects

includeDesignSystem

boolean

🎨 Include design system exports (Figma, Sketch, Adobe, etc.)

includeEverything

boolean

💎 Include ALL features above + usage tips + color psychology!

Example Request

POST https://api.colorgenius.dev/v1/palettes
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "type": "complementary",
  "count": 5,
  "format": "hex"
}

Example Response

{
  "success": true,
  "data": {
    "colors": [
      "#FF5733",
      "#33FF57",
      "#5733FF",
      "#FF3357",
      "#57FF33"
    ],
    "originalColors": [
      "#FF5733",
      "#33FF57",
      "#5733FF",
      "#FF3357",
      "#57FF33"
    ],
    "type": "complementary",
    "format": "hex",
    "count": 5,
    "metadata": {
      "tailwindConfig": "// Tailwind configuration...",
      "cssVariables": ":root { --brand-500: #FF5733; }"
    }
  },
  "timestamp": "2025-06-15T18:22:59.625Z"
}