Skip to main content
Section ID: DOC-API-MODEL-schema-p16s9mefht#overview

ThreadSummary

Conversation summary returned by thread listing and detail operations.

Meaning and usage​

Section ID: DOC-API-MODEL-schema-p16s9mefht#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-p16s9mefht#fields

UsageFields and validation
In responsesView fields

In responses​

Section ID: DOC-API-MODEL-schema-p16s9mefht#response

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-threadidSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-threadidthreadIdstringOptionalIdentifier of the conversation thread.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-useridSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-useriduserIdstringOptionalIdentifier of the user associated with the conversation thread.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-titleSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-titletitlestringOptionalDisplay title of the conversation thread.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-tagsSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-tagstagsArray of stringOptionalLabels associated with the conversation thread.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-statusSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-statusstatusstring (CONVERSATION_STATUS_ACTIVE, CONVERSATION_STATUS_ARCHIVED) or integer (int32)Optional; explicit presenceLifecycle status recorded for the conversation thread.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-messagecountSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-messagecountmessageCountstring (int64)OptionalNumber of messages recorded in the thread summary. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-lastmessagepreviewSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-lastmessagepreviewlastMessagePreviewstringOptionalText preview of the most recently projected message.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-lastmessageatSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-lastmessageatlastMessageAtstring (date-time)OptionalTimestamp of the most recently projected message.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-createdatSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-createdatcreatedAtstring (date-time)OptionalTimestamp when the conversation thread was created.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-updatedatSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-updatedatupdatedAtstring (date-time)OptionalTimestamp when the conversation thread summary was last updated.
Section ID: DOC-API-MODEL-schema-p16s9mefht#field-externalidSection ID: DOC-API-MODEL-schema-p16s9mefht#response-field-externalidexternalIdstringOptionalCaller-supplied identifier associated with the conversation thread.

Values of status​

Section ID: DOC-API-MODEL-schema-p16s9mefht#response-values-status

Lifecycle condition of a stored conversation: active or archived. This is separate from the execution status of an individual generation run.

ValueNo.FormMeaning
CONVERSATION_STATUS_ACTIVE0CanonicalThe conversation is in its active lifecycle state.
CONVERSATION_STATUS_ARCHIVED1CanonicalThe conversation has been archived; this is a stored lifecycle condition, not a generation outcome.

Where used​

Section ID: DOC-API-MODEL-schema-p16s9mefht#where-used

ReferenceRelationship
List conversation threadsPOST /api/v1/llm/list-threads

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-p16s9mefht