@@ -1366,8 +1366,8 @@ paths:
13661366 post:
13671367 tags:
13681368 - Insights
1369- summary: Read insights
1370- description: Reads the aggregate information for each user, query, and content .
1369+ summary: Get insights
1370+ description: Gets the aggregate usage insights data displayed in the Insights Dashboards .
13711371 operationId: insights
13721372 x-visibility: Public
13731373 x-codegen-request-body-name: payload
@@ -1377,7 +1377,7 @@ paths:
13771377 application/json:
13781378 schema:
13791379 $ref: "#/components/schemas/InsightsRequest"
1380- description: Includes request params for insights dashboard data .
1380+ description: Includes request parameters for insights requests .
13811381 required: true
13821382 x-exportParamName: InsightsRequest
13831383 responses:
@@ -3190,6 +3190,7 @@ paths:
31903190 description: Conflict
31913191 x-speakeasy-name-override: upload
31923192 x-speakeasy-group: indexing.shortcuts
3193+ /api/index/v1/debug/{datasource}/document/events: {}
31933194 /rest/api/v1/governance/data/policies/{id}:
31943195 get:
31953196 description: Fetches the specified policy version, or the latest if no version is provided.
@@ -8079,6 +8080,41 @@ components:
80798080 cursor:
80808081 type: string
80818082 description: Cursor that indicates the start of the next page of results. To be passed in "more" requests for this query.
8083+ InsightsOverviewRequest:
8084+ properties:
8085+ departments:
8086+ type: array
8087+ items:
8088+ type: string
8089+ description: Departments for which Insights are requested.
8090+ dayRange:
8091+ $ref: "#/components/schemas/Period"
8092+ description: Time period for which Insights are requested.
8093+ InsightsAssistantRequest:
8094+ properties:
8095+ departments:
8096+ type: array
8097+ items:
8098+ type: string
8099+ description: Departments for which Insights are requested.
8100+ dayRange:
8101+ $ref: "#/components/schemas/Period"
8102+ description: Time period for which Insights are requested.
8103+ AgentsInsightsV2Request:
8104+ properties:
8105+ agentIds:
8106+ type: array
8107+ items:
8108+ type: string
8109+ description: IDs of the Agents for which Insights should be returned. An empty array signifies all.
8110+ departments:
8111+ type: array
8112+ items:
8113+ type: string
8114+ description: Departments for which Insights are requested.
8115+ dayRange:
8116+ $ref: "#/components/schemas/Period"
8117+ description: Time period for which Insights are requested.
80828118 InsightsAiAppRequestOptions:
80838119 type: object
80848120 properties:
@@ -8095,16 +8131,33 @@ components:
80958131 items:
80968132 type: string
80978133 description: IDs of the Agents for which Insights should be returned. An empty array signifies all.
8098- DownloadInsightsRequest:
8099- required:
8100- - categories
8134+ InsightsRequest:
81018135 properties:
8136+ overviewRequest:
8137+ $ref: "#/components/schemas/InsightsOverviewRequest"
8138+ x-visibility: Public
8139+ description: If specified, will return data for the Overview section of the Insights Dashboard.
8140+ assistantRequest:
8141+ $ref: "#/components/schemas/InsightsAssistantRequest"
8142+ x-visibility: Public
8143+ description: If specified, will return data for the Assistant section of the Insights Dashboard.
8144+ agentsRequest:
8145+ $ref: "#/components/schemas/AgentsInsightsV2Request"
8146+ x-visibility: Public
8147+ description: If specified, will return data for the Agents section of the Insights Dashboard.
8148+ disablePerUserInsights:
8149+ type: boolean
8150+ description: If true, suppresses the generation of per-user Insights in the response. Default is false.
81028151 categories:
8152+ deprecated: true
81038153 type: array
81048154 items:
81058155 type: string
81068156 enum:
81078157 - AGENTS
8158+ - AGENT_USERS
8159+ - TOP_AGENTS
8160+ - AGENTS_USAGE_BY_DEPARTMENT
81088161 - AI
81098162 - AI_APPS
81108163 - ANNOUNCEMENTS
@@ -8117,34 +8170,31 @@ components:
81178170 - USERS
81188171 description: Categories of data requested. Request can include single or multiple types.
81198172 departments:
8173+ deprecated: true
81208174 type: array
81218175 items:
81228176 type: string
81238177 description: Departments that the data is requested for. If this is empty, corresponds to whole company.
81248178 dayRange:
8179+ deprecated: true
81258180 $ref: "#/components/schemas/Period"
81268181 aiAppRequestOptions:
8182+ deprecated: true
81278183 $ref: "#/components/schemas/InsightsAiAppRequestOptions"
81288184 agentsRequestOptions:
8185+ deprecated: true
81298186 $ref: "#/components/schemas/InsightsAgentsRequestOptions"
8130- InsightsRequest:
8131- allOf:
8132- - $ref: "#/components/schemas/DownloadInsightsRequest"
8133- - type: object
8134- properties:
8135- assistantActivityTypes:
8136- type: array
8137- items:
8138- type: string
8139- enum:
8140- - GLEAN_CHAT
8141- - AI_SUMMARY
8142- - AI_ANSWER
8143- - GLEANBOT_RESPONSE
8144- description: Types of activity that should count in the definition of an Assistant Active User. Affects only insights for AI category.
8145- disablePerUserInsights:
8146- type: boolean
8147- description: If true, suppresses the generation of per-user Insights in the response. Default is false.
8187+ assistantActivityTypes:
8188+ deprecated: true
8189+ type: array
8190+ items:
8191+ type: string
8192+ enum:
8193+ - GLEAN_CHAT
8194+ - AI_SUMMARY
8195+ - AI_ANSWER
8196+ - GLEANBOT_RESPONSE
8197+ description: Types of activity that should count in the definition of an Assistant Active User. Affects only insights for AI category.
81488198 LabeledCountInfo:
81498199 required:
81508200 - label
@@ -11678,6 +11728,38 @@ components:
1167811728 - NOT_UPLOADED
1167911729 - STATUS_UNKNOWN
1168011730 example: UPLOADED
11731+ DebugDocumentLifecycleRequest:
11732+ type: object
11733+ description: Describes the request body of the /debug/{datasource}/document/events API call.
11734+ properties:
11735+ objectType:
11736+ type: string
11737+ description: Object type of the document to get lifecycle events for.
11738+ example: Article
11739+ docId:
11740+ type: string
11741+ description: Glean Document ID within the datasource to get lifecycle events for.
11742+ example: art123
11743+ startDate:
11744+ type: string
11745+ description: The start date for events to be fetched. Cannot be more than 30 days (default 7 days) in the past.
11746+ example: "2025-05-01"
11747+ maxEvents:
11748+ type: integer
11749+ description: Max number of events to be fetched. Cannot be more than 100 (default 20).
11750+ example: 50
11751+ required:
11752+ - objectType
11753+ - docId
11754+ DebugDocumentLifecycleResponse:
11755+ type: object
11756+ description: Describes the response body of the /debug/{datasource}/document/events API call
11757+ properties:
11758+ lifeCycleEvents:
11759+ type: array
11760+ description: List of lifecycle events corresponding to the document
11761+ items:
11762+ $ref: "#/components/schemas/LifeCycleEvent"
1168111763 PropertyDefinition:
1168211764 properties:
1168311765 name:
0 commit comments