PUT
/
agents
/
{agentId}
Update Agent
curl --request PUT \
  --url https://api.chat-dash.com/v1/public/agents/{agentId} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "apiId": "<string>",
  "apiKey": "<string>",
  "platformCredentials": {},
  "agentConfig": {
    "usingExternalWidget": true,
    "useImportWebhook": true,
    "isTemplate": true,
    "isSaas": true
  }
}'
{
  "message": "Agent updated successfully"
}

Headers

​
Authorization
string
required

All requests to the ChatDash API must be validated with the agency API Key found on your agency profile

Path Parameters

​
agentId
string
required

The ID of the agent

Body

application/json
​
name
string

The agent's name

​
apiId
string

The 'ID' for interacting with the agent platform's API. Varies by platform:

  • Voiceflow: Project ID
  • OpenAI: Assistant ID
  • Botpress: Messaging API webhook URL
  • Vectorshift: Chatbot Name on VectorShift
  • Flowise: Chatflow ID
  • Vapi: Assistant ID
  • Retell: Agent ID
  • ElevenLabs: Agent ID
  • n8n: N/A
  • Custom: N/A
​
apiKey
string

The 'Key' for interacting with the agent platform's API. Varies by platform:

  • Voiceflow: Dialog API Key
  • OpenAI: API Key
  • Botpress: Personal Access Token
  • Vectorshift: API Key
  • Flowise: API Key
  • Vapi: Private API Key
  • Retell: API Key
  • ElevenLabs: API Key
  • n8n: N/A
  • Custom: N/A
​
platformCredentials
object

Additional credentials for interacting with certain agent platform's API (field only required for the specified platforms below)

​
agentConfig
object

Configuration settings defining how the system will handle the agent

Response

OK

​
message
string
Example:

"Agent updated successfully"