---
title: "Generate image-brief content"
method: POST
path: "/image-briefs/generate"
tags: ["Briefs"]
---

# Generate image-brief content

`POST /image-briefs/generate`

Generate the copy for a single-image creator brief from up to 3 of your products (index 0 is the hero): the kicker, signature and winning hooks, social proof, benefits, content ideas, and shop tagline.

This returns content **without saving it** — pass the result to `POST /image-briefs` to keep it as a draft. The portal streams this generation token by token; here it is collapsed into one response.

Each call spends model tokens, so `Idempotency-Key` is required and retries replay the first result rather than regenerating. Generation is non-deterministic — the same products give different copy each time.

## Headers

- `Idempotency-Key` string, nullable
- `X-Dry-Run` string, nullable

## Request body

- ImageBriefGenerateRequest
  - `product_ids` string[], required — Products to build the brief from; index 0 is the hero. At most 3.

## Response `200`

Successful Response

- ImageBriefGenerateResponse
  - `data` BriefContent, required
    - `kicker` string
    - `signatureHooks` string[]
    - `winningHooks` WinningHook[]
      - `text` string, required
      - `lead` boolean, required
    - `socialProof` string[]
    - `benefits` Benefit[]
      - `term` string, required
      - `detail` string, required
    - `contentIdeas` ContentIdea[]
      - `title` string, required
      - `detail` string, required
    - `shopTagline` string
  - `dry_run` boolean

## Other responses

- `400` — Validation error, multi-shop key, or missing/invalid Idempotency-Key.
- `403` — API key lacks `read_write` scope (`WRITE_NOT_PERMITTED`).
- `404` — Brief or product not found in this shop.
- `409` — Idempotency conflict.
- `422` — Validation Error
- `429` — Write-tier rate limit exceeded.

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)