Create conversation

Creates a new conversation thread. Returns the created Conversation object with a unique conversation_id. If title is not provided, an AI generated title will be assigned based on the first response.

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>’.

Request

This endpoint expects an object.

titlestringOptional<=256 characters

Optional user-defined title

Response headers

x-moveworks-root-uuidstring or null

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

Response

Conversation created 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 POST https://api.moveworks.ai/rest/v1beta1/conversations \
2	-H "Assistant-Name: acmecorp-conversations-rest-api" \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"title": "Help with user permissions"
7	}'

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