---
title: "Archive Report Brief"
method: POST
path: "/archive/report-brief"
---

# Archive Report Brief

`POST /archive/report-brief`

## 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/archive/report-brief`
- Auth: none declared

One-call complete archive research package for a document, PDF, or editorial brief.

You give it: a title, audience, themes, archives to draw from, things to avoid,
and how many colours you want.

It returns: ranked colour cards with archive provenance, story order, source
confidence, pull quote, CTA line, CSS tokens, image prompt, and a one-paragraph
editorial argument -- everything needed to brief a designer, write a document,
or instruct an image model.

This is the endpoint that replaces chaining archive_search + get_colour_card
+ cliche_breaker + agent_brief separately. Two Claude calls total.

## Headers

- `x-api-key` string, nullable
- `origin` string, nullable

## Request body

- ArchiveReportBriefRequest
  - `title` string
  - `audience` string
  - `themes` string[]
  - `archives` string[]
  - `avoid` string[]
  - `n_colours` integer
  - `strict_sources` boolean
  - `confidence_threshold` number
  - `minimum_claim_strength` string
  - `output_format` string
  - `period_start` integer
  - `period_end` integer
  - `allow_partial` boolean
  - `family_card_mode` string
  - `max_family_card_share` number
  - `strict_semantic_colour` 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)