Skip to main content
POST
Request a review
Reviews are in private beta for selected accounts. Follow the review guide to submit an asset and retrieve results. To request access, contact support@trybloom.ai.

Authorizations

x-api-key
string
header
required

Bloom API key, for example x-api-key: bloom_sk_....

Headers

idempotency-key
string

Optional key for safely retrying this request. Reuse it only with the same body.

Required string length: 1 - 255

Body

application/json
brandSessionId
string<uuid>
required

Brand to review against.

assets
(Upload or public URL · object | Bloom image ID · object)[]
required

Exactly one image to review: a completed temporary upload (kind=file, uploadId), a public HTTPS image URL (kind=file, url), or a Bloom image ID (kind=image, imageId). Supported formats: PNG, JPEG, WebP, GIF, and SVG. Documents such as PDFs are not supported.

Required array length: 1 element

An image supplied by a completed temporary uploadId or a public HTTPS url. Provide exactly one, never both. Supported formats: PNG, JPEG, WebP, GIF, and SVG.

checks
enum<string>[]
required

Choose which checks to run: color, typography, logo, or copy, without duplicates. Completed outcomes are returned under results.

Minimum array length: 1
Available options:
color,
typography,
logo,
copy
context
object

Optional reviewer guidance and up to 10 supporting images. If you include context, provide nonblank notes, at least one image, or both. Empty context objects, blank notes, and the old description key are rejected.

Response

OK

data
object
required