POST
/
v1
/
chatbot

Authorizations

x-api-key
string
header
required

Body

application/json
accessLevel
string
required

The access level of the chatbot. Values can be 'PUBLIC' | 'PRIVATE' | 'PROTECTED'.

model
string
required

The model the chatbot uses. Values can be 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4o-realtime-preview-2024-10-01' | 'claude-3-5-sonnet' | 'claude-3-5-haiku' | 'gemini-pro-1.5' | 'gemini-flash-1.5'.

name
string
required

The chatbot's name.

resourceIds
string[]
required

An array of resource ids that the chatbot can use.

showBadge
boolean
required

Whether or not the chatbot should show the badge. Will default to false.

chatbotMessageColor
string

The HEX background color of the chatbot's messages. Will default to #F6F7F8.

conversationBackgroundColor
string

The HEX color of the chatbot's background color behind the messages of the selected conversation. Will default to #FFFFFF.

customSystemPrompt
string

The custom system prompt the chatbot uses. Defined only if personalityType and toneType are set to 'CUSTOM'.

enabledEmoji
boolean

Whether or not the chatbot should use emojis. Defaults to false.

gradientColors
string[]

The HEX colors of the chatbot's gradient color. Must be an array of 4 colors.

password
string

If the chatbot is private, the password to access it. Must be at least 8 characters long and contain at least one uppercase letter, one lowercase letter, one number and one special character.

personalityType
string

The personnality type of the chatbot. Values can be 'ASSISTANT' | 'COACH' | 'ADVISOR' | 'EXPERT' | 'CUSTOM'.

restrictAnswersToResourcesContentResponse
string

Answer the chatbot must return if information is not found in the resources. If not set, the chatbot will not be restricted to the knowledge from the resources.

secondaryBackgroundColor
string

The HEX color of the chatbot's secondary background color. Will default to #F6F7F8.

toneType
string

The tone the chatbot uses. Values can be 'HUMOROUS' | 'FRIENDLY' | 'FORMAL' | 'CUSTOM'.

userMessageColor
string

The HEX background color of the user's messages. Will default to #E0EEFA.

websiteIntegration
object

The website integration configuration of the chatbot. Defined if the chatbot is set to be integrated on one or more websites.

welcomeMessage
string

The chatbot's welcome message. Displayed when the chatbot is first opened.

Response

201 - application/json
accessLevel
string
required

The access level of the chatbot. Values can be 'PUBLIC' | 'PRIVATE' | 'PROTECTED'.

chatbotMessageColor
string
required

The HEX background color of the chatbot's messages.

conversationBackgroundColor
string
required

The HEX color of the chatbot's background color behind the messages of the selected conversation.

createdAt
number
required

The created date of the chatbot. Unix timestamp in milliseconds.

creator
string
required

The user id of the creator.

enabledEmoji
boolean
required

Whether or not the chatbot should use emojis.

gradientColors
string[]
required

The HEX colors of the chatbot's gradient color. Must be an array of 4 colors.

id
string
required

The chatbot's id.

model
string
required

The model the chatbot uses. Values can be 'gpt-4o-mini' | 'gpt-4-turbo-preview' | 'gpt-4' | 'gpt-4o-mini'.

name
string
required

The chatbot's name.

organisation
string
required

The organisation id of the chatbot.

resources
string[]
required

An array of resource ids that the chatbot can use.

secondaryBackgroundColor
string
required

The HEX color of the chatbot's secondary background color.

showBadge
boolean
required

Whether or not the chatbot should show the badge.

userMessageColor
string
required

The HEX background color of the user's messages.

welcomeMessage
string
required

The chatbot's welcome message. Displayed when the chatbot is first opened.

customSystemPrompt
string

The custom system prompt the chatbot uses. This defines the behavior of the chatbot.

restrictAnswersToResourcesContentResponse
string

Answer the chatbot must return if information is not found in the resources. If not set, the chatbot will not be restricted to the knowledge from the resources.

websiteIntegration
object

The website integration configuration of the chatbot. Defined if the chatbot is set to be integrated on one or more websites.