Skip to main content
PATCH
/
agents
/
{agentId}
/
convos
/
{convoId}
Update Conversation
curl --request PATCH \
  --url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos/{convoId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation": {
    "title": "<string>",
    "tags": [
      "<string>"
    ],
    "state": "ai-chatting",
    "userName": "<string>",
    "userEmail": "<string>",
    "lastMessage": "<string>"
  }
}
'
{
  "success": true,
  "message": "<string>",
  "data": {
    "ID": "<string>",
    "ts": 123,
    "messagesNum": 123,
    "title": "<string>",
    "state": "open",
    "origin": "web",
    "userID": "<string>",
    "tags": [
      "<string>"
    ],
    "user": {},
    "feedback": {}
  }
}

​
Example Request

{
  "conversation": {
    "tags": ["support", "resolved"],
    "state": "completed",
    "title": "Product Inquiry - Resolved"
  }
}
Uses partial updates - only provided fields are changed. Tags are merged with existing tags (duplicates removed).
lastModified is automatically updated when any field changes.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
agentId
string
required

The unique identifier of the agent

​
convoId
string
required

The unique identifier of the conversation

Body

application/json
​
conversation
object
required

Conversation fields to update

Response

Conversation updated successfully

​
success
boolean
required

Indicates if the update was successful

​
message
string
required

Response message with conversation ID

​
data
object
required

Conversation object with full details