Get Chat History

GET

/api/chat/history

DivinityEngine - Local development
DivinityEngine - Localhost alternative

Get chat conversation history with optional filtering

Retrieves conversation history from SQLite persistence layer with support for filtering by thread_id and limiting result count.

Query Parameters:

thread_id: Optional thread identifier to filter (replaces conversation_id)
limit: Maximum number of messages to return (default: 50)

Returns:

messages: List of conversation messages
total: Total message count
conversation_id: Thread identifier if filtered

Use Case: Chat history display, conversation retrieval, context loading

Parameters

Query Parameters

thread_id

Any of:

string
null

string

<= 100 characters

limit

Limit

integer

default: 50 >= 1 <= 500

Responses

200

Successful Response

ChatHistoryResponse

Response for /api/chat/history endpoint - ULTRA-COMPLETE (50+ fields).

Provides chat conversation history with optional filtering by conversation ID.

object

messages

required

Messages

List of chat messages

Array<object>

ChatMessageInfo

Chat message information for history retrieval - ULTRA-COMPLETE (45+ fields)

object

required

Message unique identifier

string

role

required

Role

Message role (user or assistant)

string

content

required

Content

Message content text

string

timestamp

required

Timestamp

Message creation timestamp

string format: date-time

agentUsed

Any of:

string
null

string

messageId

Any of:

string
null

string

threadId

Any of:

string
null

string

conversationId

Any of:

string
null

string

uuid

Any of:

string
null

string

modelUsed

Any of:

string
null

string

persona

Any of:

string
null

string

stance

Any of:

string
null

string

projectId

Any of:

string
null

string

isEdited

Any of:

boolean
null

boolean

isDeleted

Any of:

boolean
null

boolean

isPinned

Any of:

boolean
null

boolean

responseTimeMs

Any of:

number
null

number

tokensUsed

Any of:

integer
null

integer

promptTokens

Any of:

integer
null

integer

completionTokens

Any of:

integer
null

integer

contextSources

Any of:

Array<object>
null

Array<object>

ContextSourceInfo

RAG context source information for chat responses.

Represents a single document or source used to provide context for AI responses through Retrieval-Augmented Generation (RAG). Includes relevance scoring and source metadata for attribution and transparency.

Fields: source: Document or source identifier score: Semantic similarity score (0.0-1.0, higher is more relevant) title: Human-readable source title content_preview: Preview snippet of relevant content document_type: Type of document (e.g., ‘lore’, ‘character’, ‘world’) collection: ChromaDB collection name

Used By: - ChatResponse.context_sources - EnhancedChatResponse.context_sources - ChatMessage.context_sources - ChatMessageInfo.context_sources

object

source

required

Source

Document or source identifier

string

score

required

Score

Semantic similarity score (0.0-1.0)

number

<= 1

title

Any of:

string
null

string

contentPreview

Any of:

string
null

string

documentType

Any of:

string
null

string

collection

Any of:

string
null

string

chunkIndex

Any of:

integer
null

integer

metadata

Any of:

object
null

object

key

additional properties

string

ragEnabled

Any of:

boolean
null

boolean

qualityScore

Any of:

number
null

number

<= 100

relevanceScore

Any of:

number
null

number

<= 1

confidenceScore

Any of:

number
null

number

<= 1

parentMessageId

Any of:

string
null

string

previousMessageId

Any of:

string
null

string

nextMessageId

Any of:

string
null

string

createdAt

Any of:

string
null

string

modifiedAt

Any of:

string
null

string

editedAt

Any of:

string
null

string

userId

Any of:

string
null

string

sessionId

Any of:

string
null

string

requestId

Any of:

string
null

string

tags

Any of:

Array<string>
null

Array<string>

customMetadata

Any of:

CustomMetadataInfo
null

CustomMetadataInfo

Custom metadata container for extensibility.

Provides a structured container for custom key-value metadata that doesn’t fit into predefined fields. Supports common metadata patterns.

Fields: tags: List of tags for categorization labels: Key-value labels annotations: Additional annotations source: Data source identifier version: Data version

Used By: - Various models’ custom_metadata fields

object

tags

Any of:

Array<string>
null

Array<string>

labels

Any of:

object
null

object

key

additional properties

string

annotations

Any of:

object
null

object

key

additional properties

string

source

Any of:

string
null

string

version

Any of:

string
null

string

extra

Any of:

object
null

object

key

additional properties

string

thinkingSteps

Any of:

Array<string>
null

Array<string>

error

Any of:

string
null

string

warnings

Any of:

Array<string>
null

Array<string>

extra

Any of:

CustomMetadataInfo
null

CustomMetadataInfo

Custom metadata container for extensibility.

Provides a structured container for custom key-value metadata that doesn’t fit into predefined fields. Supports common metadata patterns.

Fields: tags: List of tags for categorization labels: Key-value labels annotations: Additional annotations source: Data source identifier version: Data version

Used By: - Various models’ custom_metadata fields

object

tags

Any of:

Array<string>
null

Array<string>

labels

Any of:

object
null

object

key

additional properties

string

annotations

Any of:

object
null

object

key

additional properties

string

source

Any of:

string
null

string

version

Any of:

string
null

string

extra

Any of:

object
null

object

key

additional properties

string

total

required

Total

Total number of messages

integer

conversationId

Any of:

string
null

string

message

required

Message

Status or informational message

string

status

Any of:

string
null

string

page

Any of:

integer
null

integer

>= 1

pageSize

Any of:

integer
null

integer

>= 1

totalPages

Any of:

integer
null

integer

hasNext

Any of:

boolean
null

boolean

hasPrevious

Any of:

boolean
null

boolean

userMessageCount

Any of:

integer
null

integer

assistantMessageCount

Any of:

integer
null

integer

totalTokens

Any of:

integer
null

integer

averageResponseTimeMs

Any of:

number
null

number

uniqueThreads

Any of:

integer
null

integer

uniqueAgents

Any of:

integer
null

integer

projectId

Any of:

string
null

string

projectName

Any of:

string
null

string

threadId

Any of:

string
null

string

filterRole

Any of:

string
null

string

filterAgent

Any of:

string
null

string

filterDateFrom

Any of:

string
null

string

filterDateTo

Any of:

string
null

string

searchQuery

Any of:

string
null

string

sortBy

Any of:

string
null

string

sortOrder

Any of:

string
null

string

queryDurationMs

Any of:

number
null

number

cacheHit

Any of:

boolean
null

boolean

cacheAgeSeconds

Any of:

number
null

number

requestId

Any of:

string
null

string

userId

Any of:

string
null

string

sessionId

Any of:

string
null

string

traceId

Any of:

string
null

string

correlationId

Any of:

string
null

string

apiVersion

Any of:

string
null

string

serverVersion

Any of:

string
null

string

clientVersion

Any of:

string
null

string

timestamp

Any of:

string
null

string

oldestMessageTimestamp

Any of:

string
null

string

newestMessageTimestamp

Any of:

string
null

string

errors

Any of:

Array<string>
null

Array<string>

warnings

Any of:

Array<string>
null

Array<string>

errorCount

Any of:

integer
null

integer

warningCount

Any of:

integer
null

integer

environment

Any of:

string
null

string

region

Any of:

string
null

string

customMetadata

Any of:

CustomMetadataInfo
null

CustomMetadataInfo

Custom metadata container for extensibility.

Provides a structured container for custom key-value metadata that doesn’t fit into predefined fields. Supports common metadata patterns.

Fields: tags: List of tags for categorization labels: Key-value labels annotations: Additional annotations source: Data source identifier version: Data version

Used By: - Various models’ custom_metadata fields

object

tags

Any of:

Array<string>
null

Array<string>

labels

Any of:

object
null

object

key

additional properties

string

annotations

Any of:

object
null

object

key

additional properties

string

source

Any of:

string
null

string

version

Any of:

string
null

string

extra

Any of:

object
null

object

key

additional properties

string

deprecationNotice

Any of:

string
null

string

migrationGuide

Any of:

string
null

string

extra

Any of:

CustomMetadataInfo
null

CustomMetadataInfo

Custom metadata container for extensibility.

Provides a structured container for custom key-value metadata that doesn’t fit into predefined fields. Supports common metadata patterns.

Fields: tags: List of tags for categorization labels: Key-value labels annotations: Additional annotations source: Data source identifier version: Data version

Used By: - Various models’ custom_metadata fields

object

tags

Any of:

Array<string>
null

Array<string>

labels

Any of:

object
null

object

key

additional properties

string

annotations

Any of:

object
null

object

key

additional properties

string

source

Any of:

string
null

string

version

Any of:

string
null

string

extra

Any of:

object
null

object

key

additional properties

string

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object