---
title: "Colour Probe"
method: POST
path: "/api/v1/fashion-photoshoot/internal/colour-probe"
tags: ["fashionPhotoshoot"]
---

# Colour Probe

`POST /api/v1/fashion-photoshoot/internal/colour-probe`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/fashion-photoshoot/internal/colour-probe`
- Auth: HTTP bearer

INTERNAL. Grade a garment, show the prompt it produces, and measure a result.

404s for anyone outside the team (`require_internal`, inside the view). Generates no
image; the only cost is the cached vision call.

`result_image` is optional and is the only source of a ΔE — the number is a distance
between the reference and a render, so one image cannot produce one.

## Request body `multipart/form-data`

- BodyColourProbeApiV1FashionPhotoshootInternalColourProbePost
  - `garment_image` string, binary, required
  - `result_image` string, binary, nullable
  - `category` string
  - `engine` string, nullable
  - `scene_prompt` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 37 revisions in range; 1 not diffed.

- **2026-09-16** `dda5cf04b73d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/fashion-photoshoot/internal/colour-probe/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/02d28bde684c?raw)