Get Research Queries

GET

/api/discovery/research/queries

• DivinityEngine - Local development
• DivinityEngine - Localhost alternative

Get research queries and semantic search results.

Retrieves comprehensive research data including query history, saved searches, semantic results from recent queries, and available ChromaDB collections for research discovery dashboard and API consumers.

Returns: ResearchResponse: Complete research data including: - queries: Recent query history with results - savedSearches: User-saved search configurations - semanticResults: Semantic search results from latest query - recentQueries: List of recent query strings - totalQueries: Count of queries in response - activeCollections: Available ChromaDB collections

Raises: HTTPException: 500 error if research query retrieval fails

Example Response: json { "queries": [{"id": "1", "query": "AI patterns", "results": [...]}], "savedSearches": [{"id": "s1", "name": "AI Search", "query": "AI"}], "semanticResults": [{"documentId": "d1", "similarity": 0.92}], "recentQueries": ["AI patterns", "agent architecture"], "totalQueries": 1, "activeCollections": ["documents", "research"] }

Responses

200

Successful Response

ResearchResponse

Research queries comprehensive response model.

Provides complete research query response including query history, saved searches, semantic results, and collection information for the research discovery dashboard and API endpoints.

Fields:

• queries: List of ResearchQueryItem with recent query history and results
• saved_searches: List of ResearchSavedSearch for quick re-execution
• semantic_results: List of ResearchSemanticResult from semantic search
• recent_queries: List of recent query strings (text only)
• total_queries: Total count of queries in response (non-negative integer)
• active_collections: List of available ChromaDB collection names

Usage: GET /api/discovery/research/queries returns this response model. Used by research_routes for comprehensive research data retrieval.

JSON Example:

{
  "queries": [...],
  "savedSearches": [...],
  "semanticResults": [...],
  "recentQueries": ["AI patterns", "agent architecture"],
  "totalQueries": 2,
  "activeCollections": ["documents", "research", "notes"]
}

object

queries

Queries

Query history with results

Array<object>

ResearchQueryItem

Research query with results model.

Represents a complete research query including the query text, matching results, and metadata for query history tracking and result display.

Fields:

• id: Unique identifier for the query
• query: Original search query text
• results: List of ResearchSearchResult items
• timestamp: Unix timestamp of query execution (non-negative integer)
• result_count: Total number of results found (non-negative integer)

Usage: Used within ResearchResponse to represent query history with results. Used by research_routes for query tracking and display.

JSON Example:

{
  "id": "query_456",
  "query": "AI agent patterns",
  "results": [...],
  "timestamp": 1706745600,
  "resultCount": 15
}

object

id

required

Id

Query ID

string

query

required

Query

Query text

string

results

Results

Search results

Array<object>

ResearchSearchResult

Research search result item model.

Represents a single search result from research query operations including document content, similarity scoring, and metadata for comprehensive research discovery.

Fields:

• id: Unique identifier for the search result
• content: Document content or excerpt matching the query
• similarity: Similarity score (0.0-1.0) indicating match quality
• metadata: Dictionary containing result metadata (source, type, etc.)
• timestamp: Unix timestamp of result creation (non-negative integer)

Usage: Used within ResearchQueryItem to represent individual search results. Used by research_routes for semantic search result display.

JSON Example:

{
  "id": "result_123",
  "content": "The AI agent architecture...",
  "similarity": 0.87,
  "metadata": {"source": "documents", "type": "article"},
  "timestamp": 1706745600
}

object

id

required

Id

Result ID

string

content

required

Content

Document content

string

similarity

required

Similarity

Similarity score (0.0-1.0)

number

<= 1

metadata

ResearchDocumentMetadata

Result metadata

object

title

Title

string

""

author

Author

string

""

subject

Subject

string

""

source

Source

string

""

type

Type

string

""

createdAt

Createdat

string

""

updatedAt

Updatedat

string

""

timestamp

required

Timestamp

Result timestamp (Unix)

integer

timestamp

required

Timestamp

Query timestamp (Unix)

integer

resultCount

required

Resultcount

Number of results

integer

savedSearches

Savedsearches

Saved searches

Array<object>

ResearchSavedSearch

Research saved search model.

Represents a user-saved search configuration for quick re-execution including query text, filters, and usage tracking metadata.

Fields:

• id: Unique identifier for the saved search
• name: Human-readable name for the saved search
• query: Search query text
• filters: Dictionary of search filters (optional, defaults to empty)
• created_at: Unix timestamp when search was saved (non-negative integer)
• last_used: Unix timestamp of last usage (optional, non-negative)

Usage: Used within ResearchResponse for saved search listing. Used by research_routes for saved search management.

JSON Example:

{
  "id": "saved_789",
  "name": "AI Documentation Search",
  "query": "AI agent architecture",
  "filters": {"collection": "documents"},
  "createdAt": 1706745600,
  "lastUsed": 1706832000
}

object

id

required

Id

Saved search ID

string

name

required

Name

Search name

string

query

required

Query

Search query

string

filters

ResearchSearchFilters

Query filters

object

collection

Any of:

string

string

null

null

documentType

Any of:

string

string

null

null

dateFrom

Any of:

string

string

null

null

dateTo

Any of:

string

string

null

null

createdAt

required

Createdat

Creation timestamp (Unix)

integer

lastUsed

Any of:

integer

integer

null

null

semanticResults

Semanticresults

Semantic search results

Array<object>

ResearchSemanticResult

Research semantic search result model.

Represents a semantic search result with collection information for cross-collection research discovery and document similarity analysis.

Fields:

• document_id: Unique identifier of the matched document
• document: Document content or excerpt
• similarity: Similarity score (0.0-1.0) indicating semantic match quality
• metadata: Dictionary containing document metadata
• collection: Name of the ChromaDB collection containing the document

Usage: Used within ResearchResponse for semantic search results. Used by research_routes for cross-collection semantic search display.

JSON Example:

{
  "documentId": "doc_123",
  "document": "The multi-agent orchestration system...",
  "similarity": 0.92,
  "metadata": {"title": "Architecture Guide", "type": "documentation"},
  "collection": "documents"
}

object

documentId

required

Documentid

Document ID

string

document

required

Document

Document content

string

similarity

required

Similarity

Similarity score (0.0-1.0)

number

<= 1

metadata

ResearchDocumentMetadata

Document metadata

object

title

Title

string

""

author

Author

string

""

subject

Subject

string

""

source

Source

string

""

type

Type

string

""

createdAt

Createdat

string

""

updatedAt

Updatedat

string

""

collection

required

Collection

Collection name

string

recentQueries

Recentqueries

Recent query strings

Array<string>

totalQueries

required

Totalqueries

Total queries count

integer

activeCollections

Activecollections

Available ChromaDB collections

Array<string>