Deskhero Developer Hub
Back to deskhero.com
Stats

Topics

Topics from the latest Insights clustering build, with FAQ coverage per topic. Not scoped to the filter row - the clustering is a snapshot of the whole workspace.

GET /api/{tenant:minlength(2)}/v{version:apiVersion}/stats/topics
Authorisation
Minimum role: USER

Request arguments

Name Type Source
Request body example
No input arguments

Response

Status
200 (OK)
Type
DTO_stats_topics
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_stats_topics
NameTypeReadOnlyDescription
topicsDTO_stats_topic[]Topics
build_dateDateTime (nullable)When the clustering that produced these topics finished. Null when none has run.
previous_build_dateDateTime (nullable)The build the deltas are measured against. Null when only one build exists, in which case every delta is null too.
is_buildingBooleanTrue while a build is running and there is nothing finished to show yet.
unlinked_faqsInt32Approved public FAQs not linked to any topic.
topic_groupsDTO_stats_topic_group[]The same clusters rolled up to their first label level, biggest first.
DTO_stats_topic
NameTypeReadOnlyDescription
idInt32Id
labelStringLabel
summaryStringShort AI-written description of what the topic covers.
ticketsInt32Tickets in the cluster as of the build.
approved_faqsInt32Approved public FAQs linked to the cluster.
trend_pctDouble (nullable)Change in ticket count against the previous build, in percent. Null when there is no previous build.
DTO_stats_topic_group
NameTypeReadOnlyDescription
labelStringLabel
ticketsInt32Tickets across every cluster under this theme.
approved_faqsInt32Approved public FAQs across every cluster under this theme.
topic_countInt32How many clusters were folded together here.

Generated Aug 4, 2026 18:37