Change a visitor conversation title¶
Response contains conversation_id/title/updated_at. Currently only PATCH is registered. Optional frontend PUT fallback is not an HTTP contract. Archived conversations and other visitors’ conversations cannot be changed.
PATCH https://api.moi.matrixorigin.cn/v5/public/webapp/conversations/{conversation_id}
Before you call this API¶
Set BASE_URL to the product API prefix https://api.moi.matrixorigin.cn/v5; use the corresponding product API URL for a dedicated deployment.
Prepare links and visitor identity in the same environment. Do not supply a product PAT or workspace request headers.
Request¶
curl --request PATCH \
"$BASE_URL/public/webapp/conversations/$CONVERSATION_ID?webapp=$AGENT_ID&t=$WEBAPP_TOKEN&s=$WEBAPP_SESSION" \
--header "Content-Type: application/json" \
--data @- <<JSON
{"title": "问题记录"}
JSON
Parameter |
Location |
Type |
Required |
Description |
|---|---|---|---|---|
|
Queries |
string |
Yes |
Agent ID associated with the link. |
|
Queries |
string |
Yes |
Currently valid publication token. For short-code links, resolve first, then use the short code as t. |
|
Queries |
string |
Yes |
Visitor session credential for the same publication. |
|
Path |
string |
Yes |
Active Web App conversation created by this visitor. |
|
Body |
string |
Yes |
1–100 Unicode characters after collapsing consecutive whitespace and trimming leading/trailing whitespace. |
Successful response¶
{
"code": 0,
"data": {
"conversation_id": "conversation-example",
"title": "问题记录",
"updated_at": "2026-11-12T01:00:00Z"
}
}
Success returns HTTP 200 and numeric code=0. Read data’s object descriptions alongside the example. The conversation creation example is only a field excerpt.
Error responses¶
Public errors and identity handling distinguishes unavailable/disabled links, invalid sessions, parameters, and system failures.