Update conversation

Updates title, or archive a conversation.

Authentication

AuthorizationBearer

JWT bearer token authentication. Obtain an access token from the Moveworks auth endpoint and include it in the Authorization header as ‘Bearer <token>’.

Path parameters

conversation_idstringRequired

A base-62 identifier prefixed by a short resource type

Request

This endpoint expects an object.

titlestringOptional<=256 characters

New conversation title (optional)

archivedbooleanOptional

New archive status (optional)

Response headers

x-moveworks-root-uuidstring or null

A unique identifier used to trace your request within the Moveworks system

Response

Conversation updated successfully

conversation_idstring

A base-62 identifier prefixed by a short resource type

created_atdatetime

Creation timestamp (ISO 8601)

updated_atdatetime

Last update timestamp (ISO 8601)

titlestring or null<=256 characters

Optional user-defined title

archivedboolean or null

User-controlled flag to mark conversation as archived

1	curl -X PATCH https://api.moveworks.ai/rest/v1beta1/conversations/conv_32bt7BMLhLyVzTUjfi35N \
2	-H "Assistant-Name: acmecorp-conversations-rest-api" \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"title": "User permissions discussion",
7	"archived": true
8	}'

1	{
2	"conversation_id": "conv_32bt7BMLhLyVzTUjfi35N",
3	"created_at": "2025-01-20T10:00:00Z",
4	"updated_at": "2025-01-20T10:05:00Z",
5	"title": "User permissions discussion",
6	"archived": true
7	}