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_idstringRequiredformat: "^conv_[0-9A-HJKMNP-TV-Z]{26}$"

Unique conversation identifier (format: conv_<ulid>)

Request

This endpoint expects an object.

titlestringOptional

New conversation title (optional)

archivedbooleanOptional

New archive status (optional)

Response

Conversation updated successfully

conversation_idstring

Unique conversation identifier (format: conv_<ulid>)

archivedboolean

User-controlled flag to mark conversation as archived

created_atdatetime

Creation timestamp (ISO 8601)

updated_atdatetime

Last update timestamp (ISO 8601)

titlestring or null<=256 characters

Optional user-defined title

1	import requests
2
3	url = "https://api.moveworks.ai/rest/v1beta1/conversations/conv_01ARZ3NDEKTSV4RRFFQ69G5FAV"
4
5	payload = {
6	"title": "User permissions discussion",
7	"archived": True
8	}
9	headers = {
10	"Assistant-Name": "acmecorp-conversations-rest-api",
11	"Authorization": "Bearer <token>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.patch(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"conversation_id": "conv_01ARZ3NDEKTSV4RRFFQ69G5FAV",
3	"archived": false,
4	"created_at": "2025-01-20T10:00:00Z",
5	"updated_at": "2025-01-20T10:00:00Z",
6	"title": "Help with user permissions"
7	}

Update conversation

Authentication

Path parameters

Headers

Request

Response

Errors