Conversation Object


A conversation represents a chat thread between a user and the Wix AI coding agent about a project. A project can have multiple conversations. A conversation holds the thread's details, such as its status and title. To retrieve its messages, call Query Messages.

Properties
createdDatestringRead-onlyformat date-time

Date and time the conversation was created.


idstringRead-onlyformat GUID

Conversation ID.


projectIdstringformat GUID

ID of the project that the conversation belongs to.


revisionstringRead-onlyformat int64

Revision number, which increments by 1 each time the conversation is updated. To prevent conflicting changes, the current revision must be passed when updating the conversation.

Ignored when creating a conversation.


sessionIdstringformat GUID

ID of the coding agent session for this conversation.

Set automatically when the conversation is created. Each conversation has its own coding agent session, which later messages in the conversation resume.


statusstring

Conversation status.


titlestringmaxLength 200

Conversation title.

A new conversation is titled new chat. After the user's first message, the title is generated from that message. If a message gives no title, a later message tries again, up to 3 attempts per conversation in any 7 days. If no attempt gives a title, the conversation keeps new chat. To rename the conversation, call Update Conversation. A generated title never replaces a title that was set with Update Conversation.


updatedDatestringRead-onlyformat date-time

Date and time the conversation was last updated.

Did this help?