ThreadSummary
Conversation summary returned by thread listing and detail operations.
Usage profiles
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
threadId | string | Optional | Identifier of the conversation thread. |
userId | string | Optional | Identifier of the user associated with the conversation thread. |
title | string | Optional | Display title of the conversation thread. |
tags | Array of string | Optional | Labels associated with the conversation thread. |
status | string (CONVERSATION_STATUS_ACTIVE, CONVERSATION_STATUS_ARCHIVED) or integer (int32) | Optional | Lifecycle status recorded for the conversation thread. |
messageCount | string (int64) | Optional | Number of messages recorded in the thread summary. Pattern: ^-?\d+$. |
lastMessagePreview | string | Optional | Text preview of the most recently projected message. |
lastMessageAt | string (date-time) | Optional | Timestamp of the most recently projected message. |
createdAt | string (date-time) | Optional | Timestamp when the conversation thread was created. |
updatedAt | string (date-time) | Optional | Timestamp when the conversation thread summary was last updated. |
externalId | string | Optional | Caller-supplied identifier associated with the conversation thread. |
Values of status
Lifecycle condition of a stored conversation.
| Value | No. | Form | Meaning |
|---|---|---|---|
CONVERSATION_STATUS_ACTIVE | 1 | Canonical | The conversation is in its active lifecycle state. |
CONVERSATION_STATUS_ARCHIVED | 2 | Canonical | The conversation has been archived; this is a stored lifecycle condition, not a generation outcome. |
Where used
| Reference | Relationship |
|---|---|
| List conversation threads | POST /api/v1/llm/list-threads |
Download the public reference contract.
Document: DOC-API-MODEL-thread-summary.