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

webapp

Queries

string

Yes

Agent ID associated with the link.

t

Queries

string

Yes

Currently valid publication token. For short-code links, resolve first, then use the short code as t.

s

Queries

string

Yes

Visitor session credential for the same publication.

conversation_id

Path

string

Yes

Active Web App conversation created by this visitor.

title

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.

Last updated on