@instructure/athena-api-client 3.12.5 → 3.12.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -61,11 +61,13 @@ All URIs are relative to *http://localhost:3000*
61
61
  *AdminApi* | [**adminGetChatAnalysis**](docs/AdminApi.md#admingetchatanalysis) | **GET** /api/v1/admin/chats/{chatId}/analysis | Get chat analysis for any chat within the account
62
62
  *AdminApi* | [**adminGetCohortStats**](docs/AdminApi.md#admingetcohortstats) | **GET** /api/v1/admin/cohort-stats | Get cohort statistics for users created within a date range
63
63
  *AdminApi* | [**adminGetQuizSessionSummary**](docs/AdminApi.md#admingetquizsessionsummary) | **GET** /api/v1/admin/quiz-sessions/{sessionId}/summary | Get quiz session summary for any session within the account
64
+ *AdminApi* | [**adminGetStudyObjectiveSummary**](docs/AdminApi.md#admingetstudyobjectivesummary) | **GET** /api/v1/admin/study-objectives/summary | Aggregate study-objective statistics across all account users
64
65
  *AdminApi* | [**adminGetUserChats**](docs/AdminApi.md#admingetuserchats) | **GET** /api/v1/admin/users/{externalId}/chats | Get chats with stats for a user
65
66
  *AdminApi* | [**adminGetUserEngagement**](docs/AdminApi.md#admingetuserengagement) | **GET** /api/v1/admin/users/{externalId}/engagement | Get engagement dates for a user
66
67
  *AdminApi* | [**adminListActiveStreaks**](docs/AdminApi.md#adminlistactivestreaks) | **GET** /api/v1/admin/streaks/active | List all active streaks (currentDays > 0) across the account, paginated
67
68
  *AdminApi* | [**adminListChats**](docs/AdminApi.md#adminlistchats) | **GET** /api/v1/admin/chats | List recent chats across all account users
68
69
  *AdminApi* | [**adminListQuizSessions**](docs/AdminApi.md#adminlistquizsessions) | **GET** /api/v1/admin/quiz-sessions | List recent quiz sessions across all account users
70
+ *AdminApi* | [**adminListStudyObjectives**](docs/AdminApi.md#adminliststudyobjectives) | **GET** /api/v1/admin/study-objectives | List study objectives across all account users
69
71
  *AdminApi* | [**adminListTaxonomyEnrollments**](docs/AdminApi.md#adminlisttaxonomyenrollments) | **GET** /api/v1/admin/taxonomy-enrollments | List all taxonomy enrollments across the account
70
72
  *AdminApi* | [**adminListTopStreaks**](docs/AdminApi.md#adminlisttopstreaks) | **GET** /api/v1/admin/streaks | List top N streaks across the account
71
73
  *AdminApi* | [**adminTriggerChatAnalysis**](docs/AdminApi.md#admintriggerchatanalysis) | **POST** /api/v1/admin/chats/{chatId}/analyze | Trigger re-analysis for a chat
@@ -174,10 +176,14 @@ All URIs are relative to *http://localhost:3000*
174
176
  - [AdminPaginatedActiveStreaks](docs/AdminPaginatedActiveStreaks.md)
175
177
  - [AdminPaginatedChats](docs/AdminPaginatedChats.md)
176
178
  - [AdminPaginatedQuizSessions](docs/AdminPaginatedQuizSessions.md)
179
+ - [AdminPaginatedStudyObjectives](docs/AdminPaginatedStudyObjectives.md)
177
180
  - [AdminPaginatedTaxonomyEnrollments](docs/AdminPaginatedTaxonomyEnrollments.md)
178
181
  - [AdminQuizSessionListItem](docs/AdminQuizSessionListItem.md)
179
182
  - [AdminQuizSessionScore](docs/AdminQuizSessionScore.md)
180
183
  - [AdminStreak](docs/AdminStreak.md)
184
+ - [AdminStudyObjectiveCanvasTypeCount](docs/AdminStudyObjectiveCanvasTypeCount.md)
185
+ - [AdminStudyObjectiveListItem](docs/AdminStudyObjectiveListItem.md)
186
+ - [AdminStudyObjectiveSummary](docs/AdminStudyObjectiveSummary.md)
181
187
  - [AdminTaxonomyEnrollment](docs/AdminTaxonomyEnrollment.md)
182
188
  - [AdminTaxonomyEnrollmentTaxonomy](docs/AdminTaxonomyEnrollmentTaxonomy.md)
183
189
  - [AdminTriggerAnalysisResponse](docs/AdminTriggerAnalysisResponse.md)
@@ -10,7 +10,7 @@
10
10
  * Do not edit the class manually.
11
11
  */
12
12
  import * as runtime from '../runtime';
13
- import type { AdminChat, AdminChatAnalysis, AdminChatWithStats, AdminCohortStats, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedQuizSessions, AdminPaginatedTaxonomyEnrollments, AdminStreak, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserEngagement, QuizSessionSummary } from '../models/index';
13
+ import type { AdminChat, AdminChatAnalysis, AdminChatWithStats, AdminCohortStats, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminStreak, AdminStudyObjectiveSummary, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserEngagement, QuizSessionSummary } from '../models/index';
14
14
  export interface AdminGetChatRequest {
15
15
  xUserId: string;
16
16
  chatId: string;
@@ -28,6 +28,9 @@ export interface AdminGetQuizSessionSummaryRequest {
28
28
  xUserId: string;
29
29
  sessionId: string;
30
30
  }
31
+ export interface AdminGetStudyObjectiveSummaryRequest {
32
+ xUserId: string;
33
+ }
31
34
  export interface AdminGetUserChatsRequest {
32
35
  xUserId: string;
33
36
  externalId: string;
@@ -55,6 +58,15 @@ export interface AdminListQuizSessionsRequest {
55
58
  mode?: AdminListQuizSessionsModeEnum;
56
59
  status?: AdminListQuizSessionsStatusEnum;
57
60
  }
61
+ export interface AdminListStudyObjectivesRequest {
62
+ xUserId: string;
63
+ limit?: number;
64
+ cursor?: string;
65
+ origin?: AdminListStudyObjectivesOriginEnum;
66
+ archived?: AdminListStudyObjectivesArchivedEnum;
67
+ courseId?: string;
68
+ hasQuiz?: boolean;
69
+ }
58
70
  export interface AdminListTaxonomyEnrollmentsRequest {
59
71
  xUserId: string;
60
72
  limit?: number;
@@ -111,6 +123,16 @@ export declare class AdminApi extends runtime.BaseAPI {
111
123
  * Get quiz session summary for any session within the account
112
124
  */
113
125
  adminGetQuizSessionSummary(requestParameters: AdminGetQuizSessionSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<QuizSessionSummary>;
126
+ /**
127
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
128
+ * Aggregate study-objective statistics across all account users
129
+ */
130
+ adminGetStudyObjectiveSummaryRaw(requestParameters: AdminGetStudyObjectiveSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminStudyObjectiveSummary>>;
131
+ /**
132
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
133
+ * Aggregate study-objective statistics across all account users
134
+ */
135
+ adminGetStudyObjectiveSummary(requestParameters: AdminGetStudyObjectiveSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminStudyObjectiveSummary>;
114
136
  /**
115
137
  * Get chats with stats for a user
116
138
  */
@@ -153,6 +175,16 @@ export declare class AdminApi extends runtime.BaseAPI {
153
175
  * List recent quiz sessions across all account users
154
176
  */
155
177
  adminListQuizSessions(requestParameters: AdminListQuizSessionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedQuizSessions>;
178
+ /**
179
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
180
+ * List study objectives across all account users
181
+ */
182
+ adminListStudyObjectivesRaw(requestParameters: AdminListStudyObjectivesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminPaginatedStudyObjectives>>;
183
+ /**
184
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
185
+ * List study objectives across all account users
186
+ */
187
+ adminListStudyObjectives(requestParameters: AdminListStudyObjectivesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedStudyObjectives>;
156
188
  /**
157
189
  * List all taxonomy enrollments across the account
158
190
  */
@@ -203,3 +235,21 @@ export declare const AdminListQuizSessionsStatusEnum: {
203
235
  readonly Abandoned: "abandoned";
204
236
  };
205
237
  export type AdminListQuizSessionsStatusEnum = typeof AdminListQuizSessionsStatusEnum[keyof typeof AdminListQuizSessionsStatusEnum];
238
+ /**
239
+ * @export
240
+ */
241
+ export declare const AdminListStudyObjectivesOriginEnum: {
242
+ readonly Custom: "custom";
243
+ readonly Canvas: "canvas";
244
+ readonly Syllabus: "syllabus";
245
+ };
246
+ export type AdminListStudyObjectivesOriginEnum = typeof AdminListStudyObjectivesOriginEnum[keyof typeof AdminListStudyObjectivesOriginEnum];
247
+ /**
248
+ * @export
249
+ */
250
+ export declare const AdminListStudyObjectivesArchivedEnum: {
251
+ readonly Active: "active";
252
+ readonly Archived: "archived";
253
+ readonly All: "all";
254
+ };
255
+ export type AdminListStudyObjectivesArchivedEnum = typeof AdminListStudyObjectivesArchivedEnum[keyof typeof AdminListStudyObjectivesArchivedEnum];
@@ -22,7 +22,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
22
22
  });
23
23
  };
24
24
  Object.defineProperty(exports, "__esModule", { value: true });
25
- exports.AdminListQuizSessionsStatusEnum = exports.AdminListQuizSessionsModeEnum = exports.AdminApi = void 0;
25
+ exports.AdminListStudyObjectivesArchivedEnum = exports.AdminListStudyObjectivesOriginEnum = exports.AdminListQuizSessionsStatusEnum = exports.AdminListQuizSessionsModeEnum = exports.AdminApi = void 0;
26
26
  const runtime = require("../runtime");
27
27
  const index_1 = require("../models/index");
28
28
  /**
@@ -195,6 +195,43 @@ class AdminApi extends runtime.BaseAPI {
195
195
  return yield response.value();
196
196
  });
197
197
  }
198
+ /**
199
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
200
+ * Aggregate study-objective statistics across all account users
201
+ */
202
+ adminGetStudyObjectiveSummaryRaw(requestParameters, initOverrides) {
203
+ return __awaiter(this, void 0, void 0, function* () {
204
+ if (requestParameters['xUserId'] == null) {
205
+ throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminGetStudyObjectiveSummary().');
206
+ }
207
+ const queryParameters = {};
208
+ const headerParameters = {};
209
+ if (requestParameters['xUserId'] != null) {
210
+ headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
211
+ }
212
+ if (this.configuration && this.configuration.apiKey) {
213
+ headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
214
+ }
215
+ let urlPath = `/api/v1/admin/study-objectives/summary`;
216
+ const response = yield this.request({
217
+ path: urlPath,
218
+ method: 'GET',
219
+ headers: headerParameters,
220
+ query: queryParameters,
221
+ }, initOverrides);
222
+ return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AdminStudyObjectiveSummaryFromJSON)(jsonValue));
223
+ });
224
+ }
225
+ /**
226
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
227
+ * Aggregate study-objective statistics across all account users
228
+ */
229
+ adminGetStudyObjectiveSummary(requestParameters, initOverrides) {
230
+ return __awaiter(this, void 0, void 0, function* () {
231
+ const response = yield this.adminGetStudyObjectiveSummaryRaw(requestParameters, initOverrides);
232
+ return yield response.value();
233
+ });
234
+ }
198
235
  /**
199
236
  * Get chats with stats for a user
200
237
  */
@@ -410,6 +447,61 @@ class AdminApi extends runtime.BaseAPI {
410
447
  return yield response.value();
411
448
  });
412
449
  }
450
+ /**
451
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
452
+ * List study objectives across all account users
453
+ */
454
+ adminListStudyObjectivesRaw(requestParameters, initOverrides) {
455
+ return __awaiter(this, void 0, void 0, function* () {
456
+ if (requestParameters['xUserId'] == null) {
457
+ throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminListStudyObjectives().');
458
+ }
459
+ const queryParameters = {};
460
+ if (requestParameters['limit'] != null) {
461
+ queryParameters['limit'] = requestParameters['limit'];
462
+ }
463
+ if (requestParameters['cursor'] != null) {
464
+ queryParameters['cursor'] = requestParameters['cursor'];
465
+ }
466
+ if (requestParameters['origin'] != null) {
467
+ queryParameters['origin'] = requestParameters['origin'];
468
+ }
469
+ if (requestParameters['archived'] != null) {
470
+ queryParameters['archived'] = requestParameters['archived'];
471
+ }
472
+ if (requestParameters['courseId'] != null) {
473
+ queryParameters['courseId'] = requestParameters['courseId'];
474
+ }
475
+ if (requestParameters['hasQuiz'] != null) {
476
+ queryParameters['hasQuiz'] = requestParameters['hasQuiz'];
477
+ }
478
+ const headerParameters = {};
479
+ if (requestParameters['xUserId'] != null) {
480
+ headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
481
+ }
482
+ if (this.configuration && this.configuration.apiKey) {
483
+ headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
484
+ }
485
+ let urlPath = `/api/v1/admin/study-objectives`;
486
+ const response = yield this.request({
487
+ path: urlPath,
488
+ method: 'GET',
489
+ headers: headerParameters,
490
+ query: queryParameters,
491
+ }, initOverrides);
492
+ return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AdminPaginatedStudyObjectivesFromJSON)(jsonValue));
493
+ });
494
+ }
495
+ /**
496
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
497
+ * List study objectives across all account users
498
+ */
499
+ adminListStudyObjectives(requestParameters, initOverrides) {
500
+ return __awaiter(this, void 0, void 0, function* () {
501
+ const response = yield this.adminListStudyObjectivesRaw(requestParameters, initOverrides);
502
+ return yield response.value();
503
+ });
504
+ }
413
505
  /**
414
506
  * List all taxonomy enrollments across the account
415
507
  */
@@ -589,3 +681,19 @@ exports.AdminListQuizSessionsStatusEnum = {
589
681
  Completed: 'completed',
590
682
  Abandoned: 'abandoned'
591
683
  };
684
+ /**
685
+ * @export
686
+ */
687
+ exports.AdminListStudyObjectivesOriginEnum = {
688
+ Custom: 'custom',
689
+ Canvas: 'canvas',
690
+ Syllabus: 'syllabus'
691
+ };
692
+ /**
693
+ * @export
694
+ */
695
+ exports.AdminListStudyObjectivesArchivedEnum = {
696
+ Active: 'active',
697
+ Archived: 'archived',
698
+ All: 'all'
699
+ };
@@ -10,7 +10,7 @@
10
10
  * Do not edit the class manually.
11
11
  */
12
12
  import * as runtime from '../runtime';
13
- import type { AdminChat, AdminChatAnalysis, AdminChatWithStats, AdminCohortStats, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedQuizSessions, AdminPaginatedTaxonomyEnrollments, AdminStreak, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserEngagement, QuizSessionSummary } from '../models/index';
13
+ import type { AdminChat, AdminChatAnalysis, AdminChatWithStats, AdminCohortStats, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminStreak, AdminStudyObjectiveSummary, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserEngagement, QuizSessionSummary } from '../models/index';
14
14
  export interface AdminGetChatRequest {
15
15
  xUserId: string;
16
16
  chatId: string;
@@ -28,6 +28,9 @@ export interface AdminGetQuizSessionSummaryRequest {
28
28
  xUserId: string;
29
29
  sessionId: string;
30
30
  }
31
+ export interface AdminGetStudyObjectiveSummaryRequest {
32
+ xUserId: string;
33
+ }
31
34
  export interface AdminGetUserChatsRequest {
32
35
  xUserId: string;
33
36
  externalId: string;
@@ -55,6 +58,15 @@ export interface AdminListQuizSessionsRequest {
55
58
  mode?: AdminListQuizSessionsModeEnum;
56
59
  status?: AdminListQuizSessionsStatusEnum;
57
60
  }
61
+ export interface AdminListStudyObjectivesRequest {
62
+ xUserId: string;
63
+ limit?: number;
64
+ cursor?: string;
65
+ origin?: AdminListStudyObjectivesOriginEnum;
66
+ archived?: AdminListStudyObjectivesArchivedEnum;
67
+ courseId?: string;
68
+ hasQuiz?: boolean;
69
+ }
58
70
  export interface AdminListTaxonomyEnrollmentsRequest {
59
71
  xUserId: string;
60
72
  limit?: number;
@@ -111,6 +123,16 @@ export declare class AdminApi extends runtime.BaseAPI {
111
123
  * Get quiz session summary for any session within the account
112
124
  */
113
125
  adminGetQuizSessionSummary(requestParameters: AdminGetQuizSessionSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<QuizSessionSummary>;
126
+ /**
127
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
128
+ * Aggregate study-objective statistics across all account users
129
+ */
130
+ adminGetStudyObjectiveSummaryRaw(requestParameters: AdminGetStudyObjectiveSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminStudyObjectiveSummary>>;
131
+ /**
132
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
133
+ * Aggregate study-objective statistics across all account users
134
+ */
135
+ adminGetStudyObjectiveSummary(requestParameters: AdminGetStudyObjectiveSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminStudyObjectiveSummary>;
114
136
  /**
115
137
  * Get chats with stats for a user
116
138
  */
@@ -153,6 +175,16 @@ export declare class AdminApi extends runtime.BaseAPI {
153
175
  * List recent quiz sessions across all account users
154
176
  */
155
177
  adminListQuizSessions(requestParameters: AdminListQuizSessionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedQuizSessions>;
178
+ /**
179
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
180
+ * List study objectives across all account users
181
+ */
182
+ adminListStudyObjectivesRaw(requestParameters: AdminListStudyObjectivesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminPaginatedStudyObjectives>>;
183
+ /**
184
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
185
+ * List study objectives across all account users
186
+ */
187
+ adminListStudyObjectives(requestParameters: AdminListStudyObjectivesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedStudyObjectives>;
156
188
  /**
157
189
  * List all taxonomy enrollments across the account
158
190
  */
@@ -203,3 +235,21 @@ export declare const AdminListQuizSessionsStatusEnum: {
203
235
  readonly Abandoned: "abandoned";
204
236
  };
205
237
  export type AdminListQuizSessionsStatusEnum = typeof AdminListQuizSessionsStatusEnum[keyof typeof AdminListQuizSessionsStatusEnum];
238
+ /**
239
+ * @export
240
+ */
241
+ export declare const AdminListStudyObjectivesOriginEnum: {
242
+ readonly Custom: "custom";
243
+ readonly Canvas: "canvas";
244
+ readonly Syllabus: "syllabus";
245
+ };
246
+ export type AdminListStudyObjectivesOriginEnum = typeof AdminListStudyObjectivesOriginEnum[keyof typeof AdminListStudyObjectivesOriginEnum];
247
+ /**
248
+ * @export
249
+ */
250
+ export declare const AdminListStudyObjectivesArchivedEnum: {
251
+ readonly Active: "active";
252
+ readonly Archived: "archived";
253
+ readonly All: "all";
254
+ };
255
+ export type AdminListStudyObjectivesArchivedEnum = typeof AdminListStudyObjectivesArchivedEnum[keyof typeof AdminListStudyObjectivesArchivedEnum];
@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
21
21
  });
22
22
  };
23
23
  import * as runtime from '../runtime';
24
- import { AdminChatFromJSON, AdminChatAnalysisFromJSON, AdminChatWithStatsFromJSON, AdminCohortStatsFromJSON, AdminPaginatedActiveStreaksFromJSON, AdminPaginatedChatsFromJSON, AdminPaginatedQuizSessionsFromJSON, AdminPaginatedTaxonomyEnrollmentsFromJSON, AdminStreakFromJSON, AdminTriggerAnalysisResponseFromJSON, AdminUpdateChatRequestToJSON, AdminUserEngagementFromJSON, QuizSessionSummaryFromJSON, } from '../models/index';
24
+ import { AdminChatFromJSON, AdminChatAnalysisFromJSON, AdminChatWithStatsFromJSON, AdminCohortStatsFromJSON, AdminPaginatedActiveStreaksFromJSON, AdminPaginatedChatsFromJSON, AdminPaginatedQuizSessionsFromJSON, AdminPaginatedStudyObjectivesFromJSON, AdminPaginatedTaxonomyEnrollmentsFromJSON, AdminStreakFromJSON, AdminStudyObjectiveSummaryFromJSON, AdminTriggerAnalysisResponseFromJSON, AdminUpdateChatRequestToJSON, AdminUserEngagementFromJSON, QuizSessionSummaryFromJSON, } from '../models/index';
25
25
  /**
26
26
  *
27
27
  */
@@ -192,6 +192,43 @@ export class AdminApi extends runtime.BaseAPI {
192
192
  return yield response.value();
193
193
  });
194
194
  }
195
+ /**
196
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
197
+ * Aggregate study-objective statistics across all account users
198
+ */
199
+ adminGetStudyObjectiveSummaryRaw(requestParameters, initOverrides) {
200
+ return __awaiter(this, void 0, void 0, function* () {
201
+ if (requestParameters['xUserId'] == null) {
202
+ throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminGetStudyObjectiveSummary().');
203
+ }
204
+ const queryParameters = {};
205
+ const headerParameters = {};
206
+ if (requestParameters['xUserId'] != null) {
207
+ headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
208
+ }
209
+ if (this.configuration && this.configuration.apiKey) {
210
+ headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
211
+ }
212
+ let urlPath = `/api/v1/admin/study-objectives/summary`;
213
+ const response = yield this.request({
214
+ path: urlPath,
215
+ method: 'GET',
216
+ headers: headerParameters,
217
+ query: queryParameters,
218
+ }, initOverrides);
219
+ return new runtime.JSONApiResponse(response, (jsonValue) => AdminStudyObjectiveSummaryFromJSON(jsonValue));
220
+ });
221
+ }
222
+ /**
223
+ * Returns counts of study objectives within the caller\'s account, broken down by origin (custom user-created, Canvas-sourced, syllabus-derived) and archive state, plus how many users created a custom objective and a breakdown of Canvas-sourced objectives by Canvas object type. Intended for admin-style analytics views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
224
+ * Aggregate study-objective statistics across all account users
225
+ */
226
+ adminGetStudyObjectiveSummary(requestParameters, initOverrides) {
227
+ return __awaiter(this, void 0, void 0, function* () {
228
+ const response = yield this.adminGetStudyObjectiveSummaryRaw(requestParameters, initOverrides);
229
+ return yield response.value();
230
+ });
231
+ }
195
232
  /**
196
233
  * Get chats with stats for a user
197
234
  */
@@ -407,6 +444,61 @@ export class AdminApi extends runtime.BaseAPI {
407
444
  return yield response.value();
408
445
  });
409
446
  }
447
+ /**
448
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
449
+ * List study objectives across all account users
450
+ */
451
+ adminListStudyObjectivesRaw(requestParameters, initOverrides) {
452
+ return __awaiter(this, void 0, void 0, function* () {
453
+ if (requestParameters['xUserId'] == null) {
454
+ throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminListStudyObjectives().');
455
+ }
456
+ const queryParameters = {};
457
+ if (requestParameters['limit'] != null) {
458
+ queryParameters['limit'] = requestParameters['limit'];
459
+ }
460
+ if (requestParameters['cursor'] != null) {
461
+ queryParameters['cursor'] = requestParameters['cursor'];
462
+ }
463
+ if (requestParameters['origin'] != null) {
464
+ queryParameters['origin'] = requestParameters['origin'];
465
+ }
466
+ if (requestParameters['archived'] != null) {
467
+ queryParameters['archived'] = requestParameters['archived'];
468
+ }
469
+ if (requestParameters['courseId'] != null) {
470
+ queryParameters['courseId'] = requestParameters['courseId'];
471
+ }
472
+ if (requestParameters['hasQuiz'] != null) {
473
+ queryParameters['hasQuiz'] = requestParameters['hasQuiz'];
474
+ }
475
+ const headerParameters = {};
476
+ if (requestParameters['xUserId'] != null) {
477
+ headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
478
+ }
479
+ if (this.configuration && this.configuration.apiKey) {
480
+ headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
481
+ }
482
+ let urlPath = `/api/v1/admin/study-objectives`;
483
+ const response = yield this.request({
484
+ path: urlPath,
485
+ method: 'GET',
486
+ headers: headerParameters,
487
+ query: queryParameters,
488
+ }, initOverrides);
489
+ return new runtime.JSONApiResponse(response, (jsonValue) => AdminPaginatedStudyObjectivesFromJSON(jsonValue));
490
+ });
491
+ }
492
+ /**
493
+ * Returns a paginated list of study objectives belonging to users within the caller\'s account, ordered by creation date (newest first), with the owning user\'s external id, derived origin, linked Canvas object metadata, and resource/quiz engagement counts. Filter by origin to isolate custom (workaround) objectives, or pass a courseId to inspect everything generated for a course. Intended for admin-style views; authorization on whether the calling user is allowed to act as an admin is the calling application\'s responsibility - this endpoint only enforces account isolation.
494
+ * List study objectives across all account users
495
+ */
496
+ adminListStudyObjectives(requestParameters, initOverrides) {
497
+ return __awaiter(this, void 0, void 0, function* () {
498
+ const response = yield this.adminListStudyObjectivesRaw(requestParameters, initOverrides);
499
+ return yield response.value();
500
+ });
501
+ }
410
502
  /**
411
503
  * List all taxonomy enrollments across the account
412
504
  */
@@ -585,3 +677,19 @@ export const AdminListQuizSessionsStatusEnum = {
585
677
  Completed: 'completed',
586
678
  Abandoned: 'abandoned'
587
679
  };
680
+ /**
681
+ * @export
682
+ */
683
+ export const AdminListStudyObjectivesOriginEnum = {
684
+ Custom: 'custom',
685
+ Canvas: 'canvas',
686
+ Syllabus: 'syllabus'
687
+ };
688
+ /**
689
+ * @export
690
+ */
691
+ export const AdminListStudyObjectivesArchivedEnum = {
692
+ Active: 'active',
693
+ Archived: 'archived',
694
+ All: 'all'
695
+ };
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Athena API
3
+ * REST API for the Athena system
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { AdminStudyObjectiveListItem } from './AdminStudyObjectiveListItem';
13
+ /**
14
+ *
15
+ * @export
16
+ * @interface AdminPaginatedStudyObjectives
17
+ */
18
+ export interface AdminPaginatedStudyObjectives {
19
+ /**
20
+ * Array of study objective objects
21
+ * @type {Array<AdminStudyObjectiveListItem>}
22
+ * @memberof AdminPaginatedStudyObjectives
23
+ */
24
+ data: Array<AdminStudyObjectiveListItem>;
25
+ /**
26
+ * Opaque cursor for fetching the next page. Null when there are no more results.
27
+ * @type {string}
28
+ * @memberof AdminPaginatedStudyObjectives
29
+ */
30
+ nextCursor: string | null;
31
+ }
32
+ /**
33
+ * Check if a given object implements the AdminPaginatedStudyObjectives interface.
34
+ */
35
+ export declare function instanceOfAdminPaginatedStudyObjectives(value: object): value is AdminPaginatedStudyObjectives;
36
+ export declare function AdminPaginatedStudyObjectivesFromJSON(json: any): AdminPaginatedStudyObjectives;
37
+ export declare function AdminPaginatedStudyObjectivesFromJSONTyped(json: any, ignoreDiscriminator: boolean): AdminPaginatedStudyObjectives;
38
+ export declare function AdminPaginatedStudyObjectivesToJSON(json: any): AdminPaginatedStudyObjectives;
39
+ export declare function AdminPaginatedStudyObjectivesToJSONTyped(value?: AdminPaginatedStudyObjectives | null, ignoreDiscriminator?: boolean): any;
@@ -0,0 +1,48 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Athena API
5
+ * REST API for the Athena system
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ import { AdminStudyObjectiveListItemFromJSON, AdminStudyObjectiveListItemToJSON, } from './AdminStudyObjectiveListItem';
15
+ /**
16
+ * Check if a given object implements the AdminPaginatedStudyObjectives interface.
17
+ */
18
+ export function instanceOfAdminPaginatedStudyObjectives(value) {
19
+ if (!('data' in value) || value['data'] === undefined)
20
+ return false;
21
+ if (!('nextCursor' in value) || value['nextCursor'] === undefined)
22
+ return false;
23
+ return true;
24
+ }
25
+ export function AdminPaginatedStudyObjectivesFromJSON(json) {
26
+ return AdminPaginatedStudyObjectivesFromJSONTyped(json, false);
27
+ }
28
+ export function AdminPaginatedStudyObjectivesFromJSONTyped(json, ignoreDiscriminator) {
29
+ if (json == null) {
30
+ return json;
31
+ }
32
+ return {
33
+ 'data': (json['data'].map(AdminStudyObjectiveListItemFromJSON)),
34
+ 'nextCursor': json['nextCursor'],
35
+ };
36
+ }
37
+ export function AdminPaginatedStudyObjectivesToJSON(json) {
38
+ return AdminPaginatedStudyObjectivesToJSONTyped(json, false);
39
+ }
40
+ export function AdminPaginatedStudyObjectivesToJSONTyped(value, ignoreDiscriminator = false) {
41
+ if (value == null) {
42
+ return value;
43
+ }
44
+ return {
45
+ 'data': (value['data'].map(AdminStudyObjectiveListItemToJSON)),
46
+ 'nextCursor': value['nextCursor'],
47
+ };
48
+ }
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Athena API
3
+ * REST API for the Athena system
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ *
14
+ * @export
15
+ * @interface AdminStudyObjectiveCanvasTypeCount
16
+ */
17
+ export interface AdminStudyObjectiveCanvasTypeCount {
18
+ /**
19
+ * Canvas object type the objectives derive from (e.g. assignment, quiz, page)
20
+ * @type {string}
21
+ * @memberof AdminStudyObjectiveCanvasTypeCount
22
+ */
23
+ objectType: string;
24
+ /**
25
+ * Number of Canvas-sourced objectives of this type
26
+ * @type {number}
27
+ * @memberof AdminStudyObjectiveCanvasTypeCount
28
+ */
29
+ count: number;
30
+ }
31
+ /**
32
+ * Check if a given object implements the AdminStudyObjectiveCanvasTypeCount interface.
33
+ */
34
+ export declare function instanceOfAdminStudyObjectiveCanvasTypeCount(value: object): value is AdminStudyObjectiveCanvasTypeCount;
35
+ export declare function AdminStudyObjectiveCanvasTypeCountFromJSON(json: any): AdminStudyObjectiveCanvasTypeCount;
36
+ export declare function AdminStudyObjectiveCanvasTypeCountFromJSONTyped(json: any, ignoreDiscriminator: boolean): AdminStudyObjectiveCanvasTypeCount;
37
+ export declare function AdminStudyObjectiveCanvasTypeCountToJSON(json: any): AdminStudyObjectiveCanvasTypeCount;
38
+ export declare function AdminStudyObjectiveCanvasTypeCountToJSONTyped(value?: AdminStudyObjectiveCanvasTypeCount | null, ignoreDiscriminator?: boolean): any;