Intelligence

5 endpoints

POST /v3/portal/intelligence/ask #
bearer admin_web reporting.view device credential

Request body

FieldTypeConstraints
conversation_idstring | nulloptional
questionstringrequiredmax length 2000
enabled_datasetsstring[]optional

Response

Returns { "data": IntelligenceAskResult }.

FieldTypeConstraints
conversation_idstring (uuid)required
messageobjectrequired
message.idstring (uuid)required
message.rolestringrequiredassistant
message.textstringrequired
message.created_atstring (date-time)required
usageobjectrequired
usage.tokens_usedintegerrequired
usage.cost_usdnumberrequired
usage.tool_callsstring[]required
GET /v3/portal/intelligence/conversations #
bearer admin_web reporting.view device credential

Chat history — this user's own past conversations, most recent first.

Response

Returns { "data": IntelligenceConversationList }.

FieldTypeConstraints
conversationsobject[]required
GET /v3/portal/intelligence/conversations/{id} #
bearer admin_web reporting.view device credential

One conversation's full transcript, for re-opening it in the chat UI.

Path parameters

NameTypeNotes
idstring

Response

Returns { "data": IntelligenceConversationMessages }.

FieldTypeConstraints
messagesobject[]required
GET /v3/portal/intelligence/insights #
bearer admin_web reporting.view device credential

Phase 2 — the dashboard's insights panel. Most recent findings first, real numbers, no LLM.

Response

Returns { "data": IntelligenceInsightList }.

FieldTypeConstraints
insightsobject[]required
GET /v3/portal/intelligence/usage #
bearer admin_web device credential

Response

Returns { "data": IntelligenceUsage }.

FieldTypeConstraints
usedintegerrequired
allowanceintegerrequired
month_keystringrequired
bonusintegerrequired