Skip to main content
PATCH
/
v1
/
chatbots
/
chatbot
/
{chatbotId}
/
conversation-starters
Update Conversation Starter
curl --request PATCH \
  --url https://interhemispheric-unwet-paulene.ngrok-free.dev/api/v1/chatbots/chatbot/{chatbotId}/conversation-starters \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "buttonTitle": "<string>",
  "buttonMessage": "<string>",
  "linkText": "<string>",
  "linkSrc": "<string>"
}
'
{
  "success": true,
  "message": "Conversation starter updated successfully",
  "data": {
    "id": "<string>",
    "chatbotId": "<string>",
    "rank": 123,
    "buttonTitle": "<string>",
    "buttonMessage": "<string>",
    "linkText": "<string>",
    "linkSrc": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}
The id field (starter ID) is required in the request body. Provide exactly one of the following combinations to update the starter type:
TypeRequired Fields
ButtonbuttonTitle + buttonMessage
LinklinkText + linkSrc
Rules:
  • Providing fields from both types returns 400 Cannot provide both button fields and link fields.
  • Providing neither type returns 400 Must provide either (buttonTitle + buttonMessage) or (linkText + linkSrc).
  • Providing only one field from a pair returns 400 as well.
  • Switching type (e.g. button → link) is supported — the opposing fields are automatically cleared.
  • Returns 404 if the starter ID does not exist.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
chatbotId
string
required

Body

application/json

Provide either (buttonTitle + buttonMessage) or (linkText + linkSrc) — not both.

​
id
string
required

ID of the conversation starter to update

​
buttonTitle
string

Button label shown in the chat widget

​
buttonMessage
string

Message sent to the bot when the button is clicked

​
linkText
string

Anchor text for a link-type starter

​
linkSrc
string

URL for a link-type starter

Response

Updated

​
success
boolean
Example:

true

​
message
string
Example:

"Conversation starter updated successfully"

​
data
object