Rename a team conversation¶
Change the name of the specified team conversation.
PATCH https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams/{team_id}/sessions/{context_id}
Before you call this API¶
BASE_URL uses the product API prefix https://api.moi.matrixorigin.cn/v5. For a dedicated deployment, use its corresponding product API address.
Prepare product identity and object identifiers in the same environment.
Request¶
curl --request PATCH \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions/$CONTEXT_ID" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID" \
--header "Content-Type: application/json" \
--data '{"name":"资料核对","expected_version":1}'
Parameter |
Location |
Type |
Required |
Description |
|---|---|---|---|---|
|
Path |
string |
Yes |
Current Workspace ID, consistent with the product identity and request headers in the same environment. |
|
Path |
string |
Yes |
Team ID from the team list or creation response. |
|
Path |
string |
Yes |
Team conversation ID from creation or the list. |
|
Body |
string |
Yes |
Nonempty conversation name. |
|
Body |
integer |
Yes |
Current conversation version. |
Use this conversation’s own version. The trimmed name must be nonempty; expected_version must be positive and match. Renaming does not reset active_task_id, pending_ingress_id, or provider sessions.
Successful response¶
{
"code": 0,
"data": {
"workspace_id": "workspace-example",
"team_id": "team-example",
"context_id": "context-example",
"name": "资料核对",
"created_by_moi_user_id": "user-example",
"updated_by_moi_user_id": "user-example",
"version": 2,
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z"
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
HTTP 200. Returns the corresponding object; confirm writes with the corresponding read operation.
Error response¶
Errors and concurrency handling distinguishes parameter, version, member/conversation state, and admission failures.