AIChatUpdateConversation¶

PUT ai/chat/conversation

Renames a conversation or archives it. Archiving hides it from the default list; nothing is deleted and the history stays readable.

Access Control¶

Allowed: client, manager, admin. Only conversations of the current session.

Request¶

RESTTCPSDK

PUT request

PUT https://{broker_domain}/ai/chat/conversation
Authorization: <JWT_TOKEN>
Content-Type: application/json

{
  "conversationId": "cnv_8f3a…",
  "title": "Stop out, account 2000067"
}

{
  "command": "AIChatUpdateConversation",
  "extID": "1",
  "data": { "conversationId": "cnv_8f3a…", "archived": true }
}

await platform.AIChatUpdateConversation({ conversationId, title: 'Stop out, account 2000067' });

Parameters¶

Parameter	Type	Description
`conversationId`	string	Conversation id
`title`	string	Optional, up to 255 characters
`archived`	bool	Optional. Move to the archive or back
`accountLogin`	int	Account context. Required for a client session of an account owner

Response Data¶

The updated conversation, in the shape returned by AIChatCreateConversation.

Errors¶

Code	Error	Description
`403`	`AI_ACCESS_DENIED`	The session may not use the assistant
`404`	`AI_CONVERSATION_NOT_FOUND`	Unknown conversation, or one of another session