POST
/
v2
/
agents
/
{agent_id}

Authorizations

Authorization
string
headerrequired

Agent/Workspace secret API key as bearer token.

Path Parameters

agent_id
string
required

The ID of the agent to create/edit

Body

application/json
agentPlatform
enum<string>
required

Platform of the Agent

Available options:
vf,
vg
title
string
required

Agent title/name

description
string

Agent description

VF_DIALOGUE_API_KEY
string

For VF agents only -- the API key for the agent

VF_PROJECT_API_KEY
string

For VF agents only -- the Project API key

theme
string

Predefined themes: 'blue-light' | 'purple-light' | 'blue-dark' | 'purple-dark' | 'custom-light' | 'custom-dark' // custom themes used along customThemeJSONString

customThemeJSONString
object

MUST JSON.stringify() this object before passing it to the API.

Custom theme object for the agent

roundedImageURL
string

Widget popup launch image

avatarImageUrl
string

Web widget chat avatar image url

headerImageUrl
string

Web widget chat header image url

bannerImageUrl
string

Web widget chat banner image url

chatBgURL
string

Chatbox background image

fontFamily
string

Google font family name Browse fonts

branding
string

Branding text under the chatbox

lang
string

Language of the agent (ISO 639-1), Learn more

UIhandoffdescription
string

Widget handoff title

UIhandoffSubdescription
string

Widget handoff subtitle

buttonsLayout
enum<string>

Layout of the buttons in the chatbox

Available options:
horizontal,
vertical
ADVANCED_customCSS
string

(Advanced) Custom CSS for the web widget

whatsappToken
string

WA access token for sending messages

whatsappNumberId
string

WA number_id connected to the agent

whatsappBusniessId
string

WA Business ID connected to the agent

webhookUrl
string

Discord webhook URL

gcloudPrivateKey
string

Google chat integration -- Service account private_key for sending messages

gcloudClientEmail
string

Google chat integration -- Service account client_email for sending messages

vg_initMessages
string[]

VG agents specific -- Array of strings for initial messages

vg_systemPrompt
string

VG agents specific -- prompt for the agent

vg_temperature
number

Temperature of the LLM

vg_defaultModel
enum<string>

model_id to use to power the agent

Available options:
gpt-3.5-turbo-0125,
gpt-4-1106-preview,
llama2-70b-4096,
mixtral-8x7b-32768,
gemma-7b-it
vg_maxTokens
number

Max tokens for the LLM to generate per interaction (message to the AI)

vg_kbDefaultDimension
number

(Advanced) Dimensions of the vector store for the agent

vg_kbTopChunks
number

(Advanced) Max chunks retrieved as context from the vector store for the agent

vg_enableUIEngine
boolean

Enable or disable the AI UI engine for the agent (Makes the AI generate UI elements on its on for the web widget)

SECRET_API_KEY
string

Agent secret API key to control kb, conversations, etc

messageDelayMS
number

Delay between messages in milliseconds

proactiveMessage
string

Popup proactive message

recordChatHistory
boolean

Record chat history on VG dashboard or not

disableSmoothScroll
boolean

Disable scroll on new messages

autoStartWidget
boolean

Autostart the widget on page load (Consumes an interaction for VF agents)

listenForUrlChanges
boolean

VF agents specific -- Listen for URL changes and send an intent to Voiceflow when the URL changes

chatForget
boolean

Forget chathistory on widget close

enableAudioSupport
boolean

Enable Mic button for voice input

enableAITranslate
boolean

VF agents specific -- Enable AI translation of the response coming from VF

disableNoReplyListener
boolean

VF agents specific -- Disable no reply listener

alwaysShowHandoff
boolean

Always show handoff popup even if no agents are online

fixedHandoffPopup
boolean

Make the handoff popup fixed instead of disappearing on scroll

smartInit
boolean

VF agents specific -- Make the AI reply to the first message on channels like WA, discord, etc by sending 2 requests on initilization instead of launching the flow only.

showHandoffEvenIfOffline
boolean

Always show handoff popup even if no agents are online

enableQuickFileUpload
boolean

Enable quick upload button for web widget

Response

200 - application/json
success
boolean
message
string
data
object