POST
/
api
/
v1
/
appearance
/
Create appearance configuration
curl --request POST \
  --url https://api.camelai.com/api/v1/appearance/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "theme_mode": "light",
  "start_message": "<string>",
  "recommendations": "<any>",
  "response_mode": "full",
  "show_sidebar": true,
  "lm_primary_background_color": "<string>",
  "lm_light_background_color": "<string>",
  "lm_dark_background_color": "<string>",
  "lm_button_outline_color": "<string>",
  "dm_primary_background_color": "<string>",
  "dm_light_background_color": "<string>",
  "dm_dark_background_color": "<string>",
  "dm_button_outline_color": "<string>"
}'
{
  "id": 123,
  "name": "<string>",
  "theme_mode": "light",
  "start_message": "<string>",
  "recommendations": "<any>",
  "response_mode": "full",
  "show_sidebar": true,
  "custom_css_vars": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "last_modified": "2023-11-07T05:31:56Z",
  "is_default": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication using Bearer scheme

Body

application/json

Serializer for OrgAppearanceConfig model.

name
string
required

Name of this appearance theme

Required string length: 1 - 100
theme_mode
enum<string>

Controls the available theme options for the organization's chat view

  • light - Light
  • dark - Dark
  • both - Both (User Choice)
Available options:
light,
dark,
both
start_message
string

Start message displayed when the chat interface opens

Maximum length: 120
recommendations
any

List of recommended questions to show on the start screen (max 500, up to 280 chars each)

response_mode
enum<string>

Response mode for the chat interface - full includes advanced features like code execution

  • full - Full
  • basic - Basic
Available options:
full,
basic
show_sidebar
boolean

Toggle visibility of the chat sidebar in the iframe.

lm_primary_background_color
string
Required string length: 1 - 7
lm_light_background_color
string
Required string length: 1 - 7
lm_dark_background_color
string
Required string length: 1 - 7
lm_button_outline_color
string
Required string length: 1 - 7
dm_primary_background_color
string
Required string length: 1 - 7
dm_light_background_color
string
Required string length: 1 - 7
dm_dark_background_color
string
Required string length: 1 - 7
dm_button_outline_color
string
Required string length: 1 - 7

Response

201 - application/json

Serializer for OrgAppearanceConfig model.

id
integer
required
name
string
required

Name of this appearance theme

Maximum length: 100
custom_css_vars
string
required
created_at
string<date-time>
required
last_modified
string<date-time>
required
is_default
string
required
theme_mode
enum<string>

Controls the available theme options for the organization's chat view

  • light - Light
  • dark - Dark
  • both - Both (User Choice)
Available options:
light,
dark,
both
start_message
string

Start message displayed when the chat interface opens

Maximum length: 120
recommendations
any

List of recommended questions to show on the start screen (max 500, up to 280 chars each)

response_mode
enum<string>

Response mode for the chat interface - full includes advanced features like code execution

  • full - Full
  • basic - Basic
Available options:
full,
basic
show_sidebar
boolean

Toggle visibility of the chat sidebar in the iframe.