---
title: "Query Conceptual"
method: POST
path: "/query/conceptual"
---

# Query Conceptual

`POST /query/conceptual`

## 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/query/conceptual`
- Auth: none declared

Ask a cultural or material colour question. Archive-grounded response.

n_results is now AUTO-DETECTED from query intent if not explicitly set:
- Single colour questions  → 1 result
- Conversational queries   → 3 results
- Palette requests         → 5 results
- Exploration queries      → 6 results

Override by passing n_results explicitly.

Example:
    {"query": "what colour represents grief", "n_results": 4}
    {"query": "toxic green pigment history", "archive": "Pigment"}

## Headers

- `x-api-key` string, nullable

## Request body

- ConceptualQuery
  - `query` string, required
  - `full_query` string
  - `n_results` integer
  - `archive` string, nullable
  - `archives` unknown[]
    - unknown
  - `conversation_history` unknown[]
    - unknown
  - `history` unknown[]
    - unknown
  - `used_names` unknown[]
    - unknown
  - `system_prompt` string, nullable
  - `include_narrative` boolean

## 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)