Skip to main content

fullChat

FullChat Model​

Represents a complete chat session with all detailed information including messages, references, and metadata.

id (integer, ReadOnly)​

Unique identifier for the chat. Automatically assigned by the system.

messages (array[FullMessage], ReadOnly)​

All chat messages ordered by msg_num. Automatically managed by the system.

references (array[Reference]) Required​

List of references used in the chat. Each item follows the Reference model.

title (string) Required​

Title of the chat. Minimum 1 character.

like (boolean, Optional)​

User's like/dislike status. This field is nullable.

comment (string, Optional)​

User's comment on the chat. This field is nullable.

metadata (object, ReadOnly)​

Chat-level metadata as key-value pairs. Values are stored as strings.

created_at (string, date-time, ReadOnly)​

Timestamp when the chat was created. Automatically set by the system.

updated_at (string, date-time, ReadOnly)​

Timestamp when the chat was last updated. Automatically maintained by the system.

matrix_mode (boolean, Optional)​

Whether matrix mode is enabled for this chat.

execution_status (string, Optional)​

Current execution status of the chat. Possible values:

  • AVAILABLE
  • RUNNING
  • ERROR
  • ENDED
  • ENDED_MAX_INTERACTIONS
  • FORCED_ENDED
  • WAITING_FOR_AUTH

assistant (integer) Required​

ID of the associated assistant.

tools (array[integer], Optional)​

List of unique tool IDs used in the chat.

total_cost (string, decimal, ReadOnly, Nullable)​

Estimated cost of the chat in USD, accumulating the cost of all its messages, including native tool calls such as web search. It is null until the first response is generated.

Example​

{
  "id": 0,
  "messages": [],
  "references": [
    {
      "reference_num": 0,
      "source": "string",
      "showed_num": 0
    }
  ],
  "title": "string",
  "like": true,
  "comment": "string",
  "metadata": {
    "channel": "web"
  },
  "created_at": "2025-05-28T14:33:02.274Z",
  "updated_at": "2025-05-28T14:33:02.274Z",
  "matrix_mode": true,
  "execution_status": "AVAILABLE",
  "assistant": 0,
  "tools": [
    0
  ],
  "total_cost": "0.0123456789"
}