@instructure/athena-api-client 4.2.1 → 4.4.0

package/README.md

@@ -65,6 +65,7 @@ All URIs are relative to *http://localhost:3000*
 *AdminApi* | [**adminGetChatAnalysis**](docs/AdminApi.md#admingetchatanalysis) | **GET** /api/v1/admin/chats/{chatId}/analysis | Get chat analysis for any chat within the account
 *AdminApi* | [**adminGetChatCanvasUsage**](docs/AdminApi.md#admingetchatcanvasusage) | **GET** /api/v1/admin/chats/{chatId}/canvas-usage | Get the Canvas courses, modules, files, and items a chat read, and the files in play for each quiz generation
 *AdminApi* | [**adminGetCohortStats**](docs/AdminApi.md#admingetcohortstats) | **GET** /api/v1/admin/cohort-stats | Get cohort statistics for users created within a date range
+*AdminApi* | [**adminGetConcept**](docs/AdminApi.md#admingetconcept) | **GET** /api/v1/admin/concepts/{id} | Get one concept with its media counts
 *AdminApi* | [**adminGetConceptDiagram**](docs/AdminApi.md#admingetconceptdiagram) | **GET** /api/v1/admin/concept-diagrams/{diagramId} | Get a library concept diagram in any state
 *AdminApi* | [**adminGetConceptImage**](docs/AdminApi.md#admingetconceptimage) | **GET** /api/v1/admin/concept-images/{imageId} | Get a library concept image in any state
 *AdminApi* | [**adminGetConceptMediaJob**](docs/AdminApi.md#admingetconceptmediajob) | **GET** /api/v1/admin/concept-media-jobs/{jobId} | Get an admin concept media generation job
@@ -86,12 +87,15 @@ All URIs are relative to *http://localhost:3000*
 *AdminApi* | [**adminListStudyObjectives**](docs/AdminApi.md#adminliststudyobjectives) | **GET** /api/v1/admin/study-objectives | List study objectives across all account users
 *AdminApi* | [**adminListStudyObjectivesByUser**](docs/AdminApi.md#adminliststudyobjectivesbyuser) | **GET** /api/v1/admin/study-objectives/by-user | Per-user study-objective counts across all account users
 *AdminApi* | [**adminListTaxonomyEnrollments**](docs/AdminApi.md#adminlisttaxonomyenrollments) | **GET** /api/v1/admin/taxonomy-enrollments | List all taxonomy enrollments across the account
+*AdminApi* | [**adminListTopConcepts**](docs/AdminApi.md#adminlisttopconcepts) | **GET** /api/v1/admin/concepts/top | List the concepts the most users have
 *AdminApi* | [**adminListTopStreaks**](docs/AdminApi.md#adminlisttopstreaks) | **GET** /api/v1/admin/streaks | List top N streaks across the account
 *AdminApi* | [**adminRegenerateConceptDiagram**](docs/AdminApi.md#adminregenerateconceptdiagramoperation) | **POST** /api/v1/admin/concept-diagrams/{diagramId}/regenerate | Enqueue a hidden revision of a concept diagram
 *AdminApi* | [**adminRegenerateConceptImage**](docs/AdminApi.md#adminregenerateconceptimageoperation) | **POST** /api/v1/admin/concept-images/{imageId}/regenerate | Enqueue a hidden revision of a concept image
 *AdminApi* | [**adminResetUserLearningData**](docs/AdminApi.md#adminresetuserlearningdata) | **POST** /api/v1/admin/users/{externalId}/reset-learning-data | Reset a user\'s Athena learning data to a blank slate
 *AdminApi* | [**adminRestoreConceptDiagram**](docs/AdminApi.md#adminrestoreconceptdiagram) | **POST** /api/v1/admin/concept-diagrams/{diagramId}/restore | Restore a soft-deleted concept diagram
 *AdminApi* | [**adminRestoreConceptImage**](docs/AdminApi.md#adminrestoreconceptimage) | **POST** /api/v1/admin/concept-images/{imageId}/restore | Restore a soft-deleted concept image
+*AdminApi* | [**adminReviseConceptDiagram**](docs/AdminApi.md#adminreviseconceptdiagramoperation) | **POST** /api/v1/admin/concept-diagrams/{diagramId}/revise | Enqueue a hidden revision of a concept diagram with only the given changes
+*AdminApi* | [**adminReviseConceptImage**](docs/AdminApi.md#adminreviseconceptimageoperation) | **POST** /api/v1/admin/concept-images/{imageId}/revise | Enqueue a hidden revision of a concept image with only the given changes
 *AdminApi* | [**adminSearchConcepts**](docs/AdminApi.md#adminsearchconcepts) | **GET** /api/v1/admin/concepts | Search the global concepts by name
 *AdminApi* | [**adminShowConceptDiagram**](docs/AdminApi.md#adminshowconceptdiagram) | **POST** /api/v1/admin/concept-diagrams/{diagramId}/show | Show a hidden concept diagram to learners
 *AdminApi* | [**adminShowConceptImage**](docs/AdminApi.md#adminshowconceptimage) | **POST** /api/v1/admin/concept-images/{imageId}/show | Show a hidden concept image to learners
@@ -280,6 +284,8 @@ All URIs are relative to *http://localhost:3000*
 - [AdminRegenerateConceptDiagramRequest](docs/AdminRegenerateConceptDiagramRequest.md)
 - [AdminRegenerateConceptImageRequest](docs/AdminRegenerateConceptImageRequest.md)
 - [AdminResetLearningDataResponse](docs/AdminResetLearningDataResponse.md)
+- [AdminReviseConceptDiagramRequest](docs/AdminReviseConceptDiagramRequest.md)
+- [AdminReviseConceptImageRequest](docs/AdminReviseConceptImageRequest.md)
 - [AdminShowConceptMediaRequest](docs/AdminShowConceptMediaRequest.md)
 - [AdminShownConceptDiagram](docs/AdminShownConceptDiagram.md)
 - [AdminShownConceptImage](docs/AdminShownConceptImage.md)
@@ -291,6 +297,7 @@ All URIs are relative to *http://localhost:3000*
 - [AdminStudyObjectiveUserCounts](docs/AdminStudyObjectiveUserCounts.md)
 - [AdminTaxonomyEnrollment](docs/AdminTaxonomyEnrollment.md)
 - [AdminTaxonomyEnrollmentTaxonomy](docs/AdminTaxonomyEnrollmentTaxonomy.md)
+- [AdminTopConcept](docs/AdminTopConcept.md)
 - [AdminTriggerAnalysisResponse](docs/AdminTriggerAnalysisResponse.md)
 - [AdminUpdateChatRequest](docs/AdminUpdateChatRequest.md)
 - [AdminUserActivity](docs/AdminUserActivity.md)

package/dist/apis/AdminApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AdminChat, AdminChatAnalysis, AdminChatCanvasUsage, AdminChatWithStats, AdminCohortStats, AdminConceptDiagramDetail, AdminConceptImageDetail, AdminConceptMediaJob, AdminConceptSearchResult, AdminGenerateConceptDiagramRequest, AdminGenerateConceptImageRequest, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedConceptDiagrams, AdminPaginatedConceptImages, AdminPaginatedLastExchanges, AdminPaginatedQuizParticipantSessions, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectiveUserCounts, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminRegenerateConceptDiagramRequest, AdminRegenerateConceptImageRequest, AdminResetLearningDataResponse, AdminShowConceptMediaRequest, AdminShownConceptDiagram, AdminShownConceptImage, AdminStreak, AdminStudyObjectiveSummary, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
+import type { AdminChat, AdminChatAnalysis, AdminChatCanvasUsage, AdminChatWithStats, AdminCohortStats, AdminConceptDiagramDetail, AdminConceptImageDetail, AdminConceptMediaJob, AdminConceptSearchResult, AdminGenerateConceptDiagramRequest, AdminGenerateConceptImageRequest, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedConceptDiagrams, AdminPaginatedConceptImages, AdminPaginatedLastExchanges, AdminPaginatedQuizParticipantSessions, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectiveUserCounts, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminRegenerateConceptDiagramRequest, AdminRegenerateConceptImageRequest, AdminResetLearningDataResponse, AdminReviseConceptDiagramRequest, AdminReviseConceptImageRequest, AdminShowConceptMediaRequest, AdminShownConceptDiagram, AdminShownConceptImage, AdminStreak, AdminStudyObjectiveSummary, AdminTopConcept, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
 export interface AdminDeleteConceptDiagramRequest {
     xUserId: string;
     diagramId: string;
@@ -44,6 +44,10 @@ export interface AdminGetCohortStatsRequest {
     since: Date;
     until: Date;
 }
+export interface AdminGetConceptRequest {
+    xUserId: string;
+    id: string;
+}
 export interface AdminGetConceptDiagramRequest {
     xUserId: string;
     diagramId: string;
@@ -168,6 +172,10 @@ export interface AdminListTaxonomyEnrollmentsRequest {
     limit?: number;
     cursor?: string;
 }
+export interface AdminListTopConceptsRequest {
+    xUserId: string;
+    limit?: number;
+}
 export interface AdminListTopStreaksRequest {
     xUserId: string;
     limit?: number;
@@ -194,6 +202,16 @@ export interface AdminRestoreConceptImageRequest {
     xUserId: string;
     imageId: string;
 }
+export interface AdminReviseConceptDiagramOperationRequest {
+    xUserId: string;
+    diagramId: string;
+    adminReviseConceptDiagramRequest: AdminReviseConceptDiagramRequest;
+}
+export interface AdminReviseConceptImageOperationRequest {
+    xUserId: string;
+    imageId: string;
+    adminReviseConceptImageRequest: AdminReviseConceptImageRequest;
+}
 export interface AdminSearchConceptsRequest {
     xUserId: string;
     query?: string;
@@ -294,6 +312,16 @@ export declare class AdminApi extends runtime.BaseAPI {
      * Get cohort statistics for users created within a date range
      */
     adminGetCohortStats(requestParameters: AdminGetCohortStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminCohortStats>;
+    /**
+     * The concept with its count of non-deleted library images and diagrams, in the same shape as a concept search result.
+     * Get one concept with its media counts
+     */
+    adminGetConceptRaw(requestParameters: AdminGetConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptSearchResult>>;
+    /**
+     * The concept with its count of non-deleted library images and diagrams, in the same shape as a concept search result.
+     * Get one concept with its media counts
+     */
+    adminGetConcept(requestParameters: AdminGetConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptSearchResult>;
     /**
      * One diagram, hidden or deleted included, with its brief and assembled HTML document and its revision lineage.
      * Get a library concept diagram in any state
@@ -494,6 +522,16 @@ export declare class AdminApi extends runtime.BaseAPI {
      * List all taxonomy enrollments across the account
      */
     adminListTaxonomyEnrollments(requestParameters: AdminListTaxonomyEnrollmentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedTaxonomyEnrollments>;
+    /**
+     * Concepts ranked by how many distinct users hold a user concept for them (a user with several account users counts once), most first, then by name. Concepts no user holds are left out. Each comes with its count of non-deleted library images and diagrams, for choosing which concepts to pre-generate media for.
+     * List the concepts the most users have
+     */
+    adminListTopConceptsRaw(requestParameters: AdminListTopConceptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<AdminTopConcept>>>;
+    /**
+     * Concepts ranked by how many distinct users hold a user concept for them (a user with several account users counts once), most first, then by name. Concepts no user holds are left out. Each comes with its count of non-deleted library images and diagrams, for choosing which concepts to pre-generate media for.
+     * List the concepts the most users have
+     */
+    adminListTopConcepts(requestParameters: AdminListTopConceptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<AdminTopConcept>>;
     /**
      * List top N streaks across the account
      */
@@ -503,22 +541,22 @@ export declare class AdminApi extends runtime.BaseAPI {
      */
     adminListTopStreaks(requestParameters: AdminListTopStreaksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<AdminStreak>>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours). To change only part of the diagram and keep the rest, use adminReviseConceptDiagram instead.
      * Enqueue a hidden revision of a concept diagram
      */
     adminRegenerateConceptDiagramRaw(requestParameters: AdminRegenerateConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours). To change only part of the diagram and keep the rest, use adminReviseConceptDiagram instead.
      * Enqueue a hidden revision of a concept diagram
      */
     adminRegenerateConceptDiagram(requestParameters: AdminRegenerateConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours). To change only part of the image and keep the rest, use adminReviseConceptImage instead.
      * Enqueue a hidden revision of a concept image
      */
     adminRegenerateConceptImageRaw(requestParameters: AdminRegenerateConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours). To change only part of the image and keep the rest, use adminReviseConceptImage instead.
      * Enqueue a hidden revision of a concept image
      */
     adminRegenerateConceptImage(requestParameters: AdminRegenerateConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
@@ -552,6 +590,26 @@ export declare class AdminApi extends runtime.BaseAPI {
      * Restore a soft-deleted concept image
      */
     adminRestoreConceptImage(requestParameters: AdminRestoreConceptImageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptImageDetail>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the authoring model gets the original diagram\'s HTML fragment and is asked to apply these changes and keep everything else. The stored brief is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new diagram is linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept diagram with only the given changes
+     */
+    adminReviseConceptDiagramRaw(requestParameters: AdminReviseConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the authoring model gets the original diagram\'s HTML fragment and is asked to apply these changes and keep everything else. The stored brief is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new diagram is linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept diagram with only the given changes
+     */
+    adminReviseConceptDiagram(requestParameters: AdminReviseConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the original image itself goes to the image model\'s edit endpoint as a reference, with instructions to apply these changes and keep everything else. The stored prompt is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new image is linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept image with only the given changes
+     */
+    adminReviseConceptImageRaw(requestParameters: AdminReviseConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the original image itself goes to the image model\'s edit endpoint as a reference, with instructions to apply these changes and keep everything else. The stored prompt is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new image is linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept image with only the given changes
+     */
+    adminReviseConceptImage(requestParameters: AdminReviseConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
     /**
      * Concepts whose name contains the query (case-insensitive), exact and prefix matches first, each with its count of non-deleted library images and diagrams. For picking the concept an admin-generated image or diagram is filed under. Without a query, concepts by name.
      * Search the global concepts by name

package/dist/apis/AdminApi.js

@@ -359,6 +359,47 @@ class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * The concept with its count of non-deleted library images and diagrams, in the same shape as a concept search result.
+     * Get one concept with its media counts
+     */
+    adminGetConceptRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminGetConcept().');
+            }
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling adminGetConcept().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/admin/concepts/{id}`;
+            urlPath = urlPath.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AdminConceptSearchResultFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * The concept with its count of non-deleted library images and diagrams, in the same shape as a concept search result.
+     * Get one concept with its media counts
+     */
+    adminGetConcept(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.adminGetConceptRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * One diagram, hidden or deleted included, with its brief and assembled HTML document and its revision lineage.
      * Get a library concept diagram in any state
@@ -1325,6 +1366,46 @@ class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Concepts ranked by how many distinct users hold a user concept for them (a user with several account users counts once), most first, then by name. Concepts no user holds are left out. Each comes with its count of non-deleted library images and diagrams, for choosing which concepts to pre-generate media for.
+     * List the concepts the most users have
+     */
+    adminListTopConceptsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminListTopConcepts().');
+            }
+            const queryParameters = {};
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/admin/concepts/top`;
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.AdminTopConceptFromJSON));
+        });
+    }
+    /**
+     * Concepts ranked by how many distinct users hold a user concept for them (a user with several account users counts once), most first, then by name. Concepts no user holds are left out. Each comes with its count of non-deleted library images and diagrams, for choosing which concepts to pre-generate media for.
+     * List the concepts the most users have
+     */
+    adminListTopConcepts(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.adminListTopConceptsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * List top N streaks across the account
      */
@@ -1364,7 +1445,7 @@ class AdminApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours). To change only part of the diagram and keep the rest, use adminReviseConceptDiagram instead.
      * Enqueue a hidden revision of a concept diagram
      */
     adminRegenerateConceptDiagramRaw(requestParameters, initOverrides) {
@@ -1400,7 +1481,7 @@ class AdminApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours). To change only part of the diagram and keep the rest, use adminReviseConceptDiagram instead.
      * Enqueue a hidden revision of a concept diagram
      */
     adminRegenerateConceptDiagram(requestParameters, initOverrides) {
@@ -1410,7 +1491,7 @@ class AdminApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours). To change only part of the image and keep the rest, use adminReviseConceptImage instead.
      * Enqueue a hidden revision of a concept image
      */
     adminRegenerateConceptImageRaw(requestParameters, initOverrides) {
@@ -1446,7 +1527,7 @@ class AdminApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours). To change only part of the image and keep the rest, use adminReviseConceptImage instead.
      * Enqueue a hidden revision of a concept image
      */
     adminRegenerateConceptImage(requestParameters, initOverrides) {
@@ -1578,6 +1659,98 @@ class AdminApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the authoring model gets the original diagram\'s HTML fragment and is asked to apply these changes and keep everything else. The stored brief is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new diagram is linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept diagram with only the given changes
+     */
+    adminReviseConceptDiagramRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminReviseConceptDiagram().');
+            }
+            if (requestParameters['diagramId'] == null) {
+                throw new runtime.RequiredError('diagramId', 'Required parameter "diagramId" was null or undefined when calling adminReviseConceptDiagram().');
+            }
+            if (requestParameters['adminReviseConceptDiagramRequest'] == null) {
+                throw new runtime.RequiredError('adminReviseConceptDiagramRequest', 'Required parameter "adminReviseConceptDiagramRequest" was null or undefined when calling adminReviseConceptDiagram().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/admin/concept-diagrams/{diagramId}/revise`;
+            urlPath = urlPath.replace(`{${"diagramId"}}`, encodeURIComponent(String(requestParameters['diagramId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.AdminReviseConceptDiagramRequestToJSON)(requestParameters['adminReviseConceptDiagramRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AdminConceptMediaJobFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the authoring model gets the original diagram\'s HTML fragment and is asked to apply these changes and keep everything else. The stored brief is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new diagram is linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept diagram with only the given changes
+     */
+    adminReviseConceptDiagram(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.adminReviseConceptDiagramRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the original image itself goes to the image model\'s edit endpoint as a reference, with instructions to apply these changes and keep everything else. The stored prompt is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new image is linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept image with only the given changes
+     */
+    adminReviseConceptImageRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling adminReviseConceptImage().');
+            }
+            if (requestParameters['imageId'] == null) {
+                throw new runtime.RequiredError('imageId', 'Required parameter "imageId" was null or undefined when calling adminReviseConceptImage().');
+            }
+            if (requestParameters['adminReviseConceptImageRequest'] == null) {
+                throw new runtime.RequiredError('adminReviseConceptImageRequest', 'Required parameter "adminReviseConceptImageRequest" was null or undefined when calling adminReviseConceptImage().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/admin/concept-images/{imageId}/revise`;
+            urlPath = urlPath.replace(`{${"imageId"}}`, encodeURIComponent(String(requestParameters['imageId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.AdminReviseConceptImageRequestToJSON)(requestParameters['adminReviseConceptImageRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.AdminConceptMediaJobFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the original image itself goes to the image model\'s edit endpoint as a reference, with instructions to apply these changes and keep everything else. The stored prompt is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new image is linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept image with only the given changes
+     */
+    adminReviseConceptImage(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.adminReviseConceptImageRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Concepts whose name contains the query (case-insensitive), exact and prefix matches first, each with its count of non-deleted library images and diagrams. For picking the concept an admin-generated image or diagram is filed under. Without a query, concepts by name.
      * Search the global concepts by name

package/dist/esm/apis/AdminApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AdminChat, AdminChatAnalysis, AdminChatCanvasUsage, AdminChatWithStats, AdminCohortStats, AdminConceptDiagramDetail, AdminConceptImageDetail, AdminConceptMediaJob, AdminConceptSearchResult, AdminGenerateConceptDiagramRequest, AdminGenerateConceptImageRequest, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedConceptDiagrams, AdminPaginatedConceptImages, AdminPaginatedLastExchanges, AdminPaginatedQuizParticipantSessions, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectiveUserCounts, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminRegenerateConceptDiagramRequest, AdminRegenerateConceptImageRequest, AdminResetLearningDataResponse, AdminShowConceptMediaRequest, AdminShownConceptDiagram, AdminShownConceptImage, AdminStreak, AdminStudyObjectiveSummary, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
+import type { AdminChat, AdminChatAnalysis, AdminChatCanvasUsage, AdminChatWithStats, AdminCohortStats, AdminConceptDiagramDetail, AdminConceptImageDetail, AdminConceptMediaJob, AdminConceptSearchResult, AdminGenerateConceptDiagramRequest, AdminGenerateConceptImageRequest, AdminPaginatedActiveStreaks, AdminPaginatedChats, AdminPaginatedConceptDiagrams, AdminPaginatedConceptImages, AdminPaginatedLastExchanges, AdminPaginatedQuizParticipantSessions, AdminPaginatedQuizSessions, AdminPaginatedStudyObjectiveUserCounts, AdminPaginatedStudyObjectives, AdminPaginatedTaxonomyEnrollments, AdminRegenerateConceptDiagramRequest, AdminRegenerateConceptImageRequest, AdminResetLearningDataResponse, AdminReviseConceptDiagramRequest, AdminReviseConceptImageRequest, AdminShowConceptMediaRequest, AdminShownConceptDiagram, AdminShownConceptImage, AdminStreak, AdminStudyObjectiveSummary, AdminTopConcept, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
 export interface AdminDeleteConceptDiagramRequest {
     xUserId: string;
     diagramId: string;
@@ -44,6 +44,10 @@ export interface AdminGetCohortStatsRequest {
     since: Date;
     until: Date;
 }
+export interface AdminGetConceptRequest {
+    xUserId: string;
+    id: string;
+}
 export interface AdminGetConceptDiagramRequest {
     xUserId: string;
     diagramId: string;
@@ -168,6 +172,10 @@ export interface AdminListTaxonomyEnrollmentsRequest {
     limit?: number;
     cursor?: string;
 }
+export interface AdminListTopConceptsRequest {
+    xUserId: string;
+    limit?: number;
+}
 export interface AdminListTopStreaksRequest {
     xUserId: string;
     limit?: number;
@@ -194,6 +202,16 @@ export interface AdminRestoreConceptImageRequest {
     xUserId: string;
     imageId: string;
 }
+export interface AdminReviseConceptDiagramOperationRequest {
+    xUserId: string;
+    diagramId: string;
+    adminReviseConceptDiagramRequest: AdminReviseConceptDiagramRequest;
+}
+export interface AdminReviseConceptImageOperationRequest {
+    xUserId: string;
+    imageId: string;
+    adminReviseConceptImageRequest: AdminReviseConceptImageRequest;
+}
 export interface AdminSearchConceptsRequest {
     xUserId: string;
     query?: string;
@@ -294,6 +312,16 @@ export declare class AdminApi extends runtime.BaseAPI {
      * Get cohort statistics for users created within a date range
      */
     adminGetCohortStats(requestParameters: AdminGetCohortStatsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminCohortStats>;
+    /**
+     * The concept with its count of non-deleted library images and diagrams, in the same shape as a concept search result.
+     * Get one concept with its media counts
+     */
+    adminGetConceptRaw(requestParameters: AdminGetConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptSearchResult>>;
+    /**
+     * The concept with its count of non-deleted library images and diagrams, in the same shape as a concept search result.
+     * Get one concept with its media counts
+     */
+    adminGetConcept(requestParameters: AdminGetConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptSearchResult>;
     /**
      * One diagram, hidden or deleted included, with its brief and assembled HTML document and its revision lineage.
      * Get a library concept diagram in any state
@@ -494,6 +522,16 @@ export declare class AdminApi extends runtime.BaseAPI {
      * List all taxonomy enrollments across the account
      */
     adminListTaxonomyEnrollments(requestParameters: AdminListTaxonomyEnrollmentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminPaginatedTaxonomyEnrollments>;
+    /**
+     * Concepts ranked by how many distinct users hold a user concept for them (a user with several account users counts once), most first, then by name. Concepts no user holds are left out. Each comes with its count of non-deleted library images and diagrams, for choosing which concepts to pre-generate media for.
+     * List the concepts the most users have
+     */
+    adminListTopConceptsRaw(requestParameters: AdminListTopConceptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<AdminTopConcept>>>;
+    /**
+     * Concepts ranked by how many distinct users hold a user concept for them (a user with several account users counts once), most first, then by name. Concepts no user holds are left out. Each comes with its count of non-deleted library images and diagrams, for choosing which concepts to pre-generate media for.
+     * List the concepts the most users have
+     */
+    adminListTopConcepts(requestParameters: AdminListTopConceptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<AdminTopConcept>>;
     /**
      * List top N streaks across the account
      */
@@ -503,22 +541,22 @@ export declare class AdminApi extends runtime.BaseAPI {
      */
     adminListTopStreaks(requestParameters: AdminListTopStreaksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<AdminStreak>>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours). To change only part of the diagram and keep the rest, use adminReviseConceptDiagram instead.
      * Enqueue a hidden revision of a concept diagram
      */
     adminRegenerateConceptDiagramRaw(requestParameters: AdminRegenerateConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new diagram is generated from an edited brief, linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours). To change only part of the diagram and keep the rest, use adminReviseConceptDiagram instead.
      * Enqueue a hidden revision of a concept diagram
      */
     adminRegenerateConceptDiagram(requestParameters: AdminRegenerateConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours). To change only part of the image and keep the rest, use adminReviseConceptImage instead.
      * Enqueue a hidden revision of a concept image
      */
     adminRegenerateConceptImageRaw(requestParameters: AdminRegenerateConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
     /**
-     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Returns 202 with a pending job at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why: off_topic, moderation_blocked, timeout, not_found, generation_failed, authoring_failed, save_failed, limit_reached, internal_error, delivery_failed). Each job runs its paid generation at most once: retry a failed job by enqueueing a new one. The new image is generated from an edited prompt, linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours). To change only part of the image and keep the rest, use adminReviseConceptImage instead.
      * Enqueue a hidden revision of a concept image
      */
     adminRegenerateConceptImage(requestParameters: AdminRegenerateConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
@@ -552,6 +590,26 @@ export declare class AdminApi extends runtime.BaseAPI {
      * Restore a soft-deleted concept image
      */
     adminRestoreConceptImage(requestParameters: AdminRestoreConceptImageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptImageDetail>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the authoring model gets the original diagram\'s HTML fragment and is asked to apply these changes and keep everything else. The stored brief is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new diagram is linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept diagram with only the given changes
+     */
+    adminReviseConceptDiagramRaw(requestParameters: AdminReviseConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the authoring model gets the original diagram\'s HTML fragment and is asked to apply these changes and keep everything else. The stored brief is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new diagram is linked to the original by revisesDiagramId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_DIAGRAM_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept diagram with only the given changes
+     */
+    adminReviseConceptDiagram(requestParameters: AdminReviseConceptDiagramOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the original image itself goes to the image model\'s edit endpoint as a reference, with instructions to apply these changes and keep everything else. The stored prompt is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new image is linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept image with only the given changes
+     */
+    adminReviseConceptImageRaw(requestParameters: AdminReviseConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AdminConceptMediaJob>>;
+    /**
+     * Returns 202 with a pending job (operation revise) at once; the generation runs in a background worker. Poll adminGetConceptMediaJob with the job id until status is succeeded (resultMediaId is the new draft) or failed (errorCode says why, as for a regenerate). Each job runs its paid generation at most once. Unlike a regenerate, the admin sends only what should change: the original image itself goes to the image model\'s edit endpoint as a reference, with instructions to apply these changes and keep everything else. The stored prompt is the original\'s with the changes appended. The changes are recorded on the new revision as revisionInstructions. The new image is linked to the original by revisesImageId even when the original is hidden or deleted, filed under the original\'s concept, attributed to the caller, and stored hidden. The original is left as it is. Counts against the caller\'s admin limit (ADMIN_CONCEPT_IMAGE_DAILY_LIMIT per rolling 24 hours).
+     * Enqueue a hidden revision of a concept image with only the given changes
+     */
+    adminReviseConceptImage(requestParameters: AdminReviseConceptImageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AdminConceptMediaJob>;
     /**
      * Concepts whose name contains the query (case-insensitive), exact and prefix matches first, each with its count of non-deleted library images and diagrams. For picking the concept an admin-generated image or diagram is filed under. Without a query, concepts by name.
      * Search the global concepts by name