---
title: "Get Scene"
method: POST
path: "/v1/scene"
---

# Get Scene

`POST /v1/scene`

## 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/v1/scene`
- Auth: none declared

Return a complete, coherent material palette for a defined period and room type.
All surfaces cross-checked for anachronisms. All illuminant values consistent.
The hard problem in historical world-building is not finding one correct colour.
It is finding twelve correct colours that were actually in the same room at the
same time and looked right together by firelight. This endpoint solves that.

## Request body

- SceneRequest
  - `period` string, required
  - `room_type` string
  - `style` string, nullable
  - `surfaces` string[]

## Response `200`

Successful Response

- SceneResponse
  - `period` string, required
  - `room_type` string, required
  - `archive` string, required
  - `period_coherent` boolean, required
  - `materials` SceneMaterial[], required
    - `surface` string, required
    - `colour_name` string, required
    - `albedo_daylight` string, required
    - `albedo_candlelight` string, required
    - `lrv` number, required
    - `substrate_class` string, required
    - `roughness_hint` number, required
    - `source` string, required
    - `claim_strength` string, required
    - `drift_flag` string, required
  - `scene_note` string, required
  - `css_variables` string, required
  - `production_bible_note` string, required

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