---
title: "Specify Palette"
method: POST
path: "/specify"
---

# Specify Palette

`POST /specify`

## Request

- Base URL: `https://api.colourmemory.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.colourmemory.com/specify`
- Auth: none declared

Generate a complete room specification from a palette of hex values.

Takes 2-8 colours and returns:
- Surface assignments (walls, ceiling, joinery, floor, accents)
- 60-30-10 proportion breakdown
- Lighting behaviour under different illuminants
- North/south facing recommendations
- Archive names for each colour
- Material and lightfastness warnings

One call. Complete specification. No further processing needed.

Example:
    POST /specify
    {"colours": ["#3A5C8C", "#E2D8C8", "#1B1556", "#C4A052"],
     "room_type": "living",
     "style": "heritage"}

## Request body

- SpecifyRequest
  - `colours` string[], required
  - `room_type` string
  - `style` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/colourmemory/apis/colour-memory-api.md) · [All operations](https://skmtc.dev/colourmemory/apis/colour-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/colourmemory/apis/colour-memory-api/revisions/4ba028f64042?raw)