---
title: "Delete an image brief"
method: DELETE
path: "/image-briefs/{brief_id}"
tags: ["Briefs"]
---

# Delete an image brief

`DELETE /image-briefs/{brief_id}`

Permanently delete a saved image brief. This is not reversible — the draft and its content are gone. Deleting an already-deleted brief returns 404.

`Idempotency-Key` is required; `X-Dry-Run: true` reports what would be deleted without deleting it.

## Path parameters

- `brief_id` integer, required

## Headers

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

## Response `200`

Successful Response

- ImageBriefDeleteResponse
  - `data` ImageBriefDeleteData, required
    - `brief_id` integer, required
    - `deleted` boolean, required
  - `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/643422c93bd8/schema)