Mood Board

Visual inspiration mood boards

List mood boards

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Query parameters

site_idstring · uuidOptional

Filter by site ID

Responses

200

A list of mood boards

application/json

get

/v1/mood-board

HTTPcURLJavaScriptPython

GET /v1/mood-board HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

A list of mood boards

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "site_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2026-03-14T14:01:04.906Z",
    "updated_at": "2026-03-14T14:01:04.906Z"
  }
]

Create mood board

post

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

namestringRequired

descriptionstringOptional

site_idstring · uuidOptional

Responses

201

Mood board created

application/json

idstring · uuidOptional

namestringOptional

descriptionstring · nullableOptional

site_idstring · uuid · nullableOptional

created_atstring · date-timeOptional

updated_atstring · date-time · nullableOptional

post

/v1/mood-board

HTTPcURLJavaScriptPython

POST /v1/mood-board HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "name": "text",
  "description": "text",
  "site_id": "123e4567-e89b-12d3-a456-426614174000"
}

201

Mood board created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-03-14T14:01:04.906Z",
  "updated_at": "2026-03-14T14:01:04.906Z"
}

Get mood board with items

get

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Mood board ID

Responses

200

Mood board with items

application/json

get

/v1/mood-board/{id}

HTTPcURLJavaScriptPython

GET /v1/mood-board/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Mood board with items

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-03-14T14:01:04.906Z",
  "updated_at": "2026-03-14T14:01:04.906Z",
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "url": "text",
      "metadata": {}
    }
  ]
}

Delete mood board

delete

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Mood board ID

Responses

200

Mood board deleted

application/json

delete

/v1/mood-board/{id}

HTTPcURLJavaScriptPython

DELETE /v1/mood-board/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Mood board deleted

{
  "deleted": true
}

Generate mood board images

post

Generate mood board images and colors from brand context. Requires Replicate API key.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

mood_board_idstring · uuidRequired

site_idstring · uuidRequired

Responses

200

Generation result

application/json

post

/v1/mood-board/generate

HTTPcURLJavaScriptPython

POST /v1/mood-board/generate HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "mood_board_id": "123e4567-e89b-12d3-a456-426614174000",
  "site_id": "123e4567-e89b-12d3-a456-426614174000"
}

200

Generation result

{}