Skip to main content
POST
Create a moodboard

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Optional caller-generated value that prevents duplicate generation when retrying the same request.

Required string length: 1 - 255

Body

application/json
product_id
string<uuid>
required
idea
string

Optional. What the moodboard should explore.

Required string length: 1 - 2000
reference_image_urls
string<uri>[]
Required array length: 1 - 8 elements
Pattern: ^https://

Response

Moodboard accepted.

id
string<uuid>
required
product_id
string<uuid>
required

The product it was made for.

status
enum<string>
required
Available options:
queued,
in_progress,
completed,
failed,
canceled
image_url
string<uri> | null
required

A 3 x 3 grid. Null until completed.

style_name
string | null
required
summary
string | null
required
idea
string | null
required
created_at
string<date-time>
required
Last modified on September 30, 2026