Conversations APIConversations

Update conversation

View as Markdown
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>)

Headers

Assistant-NamestringRequired
The Moveworks assistant identifier that was configured for your organization.

Request

This endpoint expects an object.
titlestringOptional<=256 characters

New conversation title (max 256 characters)

archivedbooleanOptional
New archived status

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 (max 256 characters)

Errors