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

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<=256 characters

Optional user-defined title

archivedboolean

User-controlled flag to mark conversation as archived

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

1	import requests
2
3	url = "https://api.moveworks.ai/rest/v1beta1/conversations/conv_32bt7BMLhLyVzTUjfi35N"
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_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	}