@instructure/athena-api-client 4.2.0 → 4.3.0

package/README.md

@@ -92,6 +92,8 @@ All URIs are relative to *http://localhost:3000*
 *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 +282,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)

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, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
 export interface AdminDeleteConceptDiagramRequest {
     xUserId: string;
     diagramId: string;
@@ -194,6 +194,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;
@@ -503,22 +513,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 +562,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

@@ -1364,7 +1364,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 +1400,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 +1410,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 +1446,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 +1578,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, AdminTriggerAnalysisResponse, AdminUpdateChatRequest, AdminUserActivity, AdminUserActivityTotals, AdminUserEngagement, AdminUsersActivityRequest, AdminUsersActivityTotalsRequest, QuizSessionSummary } from '../models/index';
 export interface AdminDeleteConceptDiagramRequest {
     xUserId: string;
     diagramId: string;
@@ -194,6 +194,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;
@@ -503,22 +513,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 +562,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/esm/apis/AdminApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { AdminChatFromJSON, AdminChatAnalysisFromJSON, AdminChatCanvasUsageFromJSON, AdminChatWithStatsFromJSON, AdminCohortStatsFromJSON, AdminConceptDiagramDetailFromJSON, AdminConceptImageDetailFromJSON, AdminConceptMediaJobFromJSON, AdminConceptSearchResultFromJSON, AdminGenerateConceptDiagramRequestToJSON, AdminGenerateConceptImageRequestToJSON, AdminPaginatedActiveStreaksFromJSON, AdminPaginatedChatsFromJSON, AdminPaginatedConceptDiagramsFromJSON, AdminPaginatedConceptImagesFromJSON, AdminPaginatedLastExchangesFromJSON, AdminPaginatedQuizParticipantSessionsFromJSON, AdminPaginatedQuizSessionsFromJSON, AdminPaginatedStudyObjectiveUserCountsFromJSON, AdminPaginatedStudyObjectivesFromJSON, AdminPaginatedTaxonomyEnrollmentsFromJSON, AdminRegenerateConceptDiagramRequestToJSON, AdminRegenerateConceptImageRequestToJSON, AdminResetLearningDataResponseFromJSON, AdminShowConceptMediaRequestToJSON, AdminShownConceptDiagramFromJSON, AdminShownConceptImageFromJSON, AdminStreakFromJSON, AdminStudyObjectiveSummaryFromJSON, AdminTriggerAnalysisResponseFromJSON, AdminUpdateChatRequestToJSON, AdminUserActivityFromJSON, AdminUserActivityTotalsFromJSON, AdminUserEngagementFromJSON, AdminUsersActivityRequestToJSON, AdminUsersActivityTotalsRequestToJSON, QuizSessionSummaryFromJSON, } from '../models/index';
+import { AdminChatFromJSON, AdminChatAnalysisFromJSON, AdminChatCanvasUsageFromJSON, AdminChatWithStatsFromJSON, AdminCohortStatsFromJSON, AdminConceptDiagramDetailFromJSON, AdminConceptImageDetailFromJSON, AdminConceptMediaJobFromJSON, AdminConceptSearchResultFromJSON, AdminGenerateConceptDiagramRequestToJSON, AdminGenerateConceptImageRequestToJSON, AdminPaginatedActiveStreaksFromJSON, AdminPaginatedChatsFromJSON, AdminPaginatedConceptDiagramsFromJSON, AdminPaginatedConceptImagesFromJSON, AdminPaginatedLastExchangesFromJSON, AdminPaginatedQuizParticipantSessionsFromJSON, AdminPaginatedQuizSessionsFromJSON, AdminPaginatedStudyObjectiveUserCountsFromJSON, AdminPaginatedStudyObjectivesFromJSON, AdminPaginatedTaxonomyEnrollmentsFromJSON, AdminRegenerateConceptDiagramRequestToJSON, AdminRegenerateConceptImageRequestToJSON, AdminResetLearningDataResponseFromJSON, AdminReviseConceptDiagramRequestToJSON, AdminReviseConceptImageRequestToJSON, AdminShowConceptMediaRequestToJSON, AdminShownConceptDiagramFromJSON, AdminShownConceptImageFromJSON, AdminStreakFromJSON, AdminStudyObjectiveSummaryFromJSON, AdminTriggerAnalysisResponseFromJSON, AdminUpdateChatRequestToJSON, AdminUserActivityFromJSON, AdminUserActivityTotalsFromJSON, AdminUserEngagementFromJSON, AdminUsersActivityRequestToJSON, AdminUsersActivityTotalsRequestToJSON, QuizSessionSummaryFromJSON, } from '../models/index';
 /**
  *
  */
@@ -1361,7 +1361,7 @@ export 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) {
@@ -1397,7 +1397,7 @@ export 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) {
@@ -1407,7 +1407,7 @@ export 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) {
@@ -1443,7 +1443,7 @@ export 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) {
@@ -1575,6 +1575,98 @@ export 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: AdminReviseConceptDiagramRequestToJSON(requestParameters['adminReviseConceptDiagramRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => 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: AdminReviseConceptImageRequestToJSON(requestParameters['adminReviseConceptImageRequest']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => 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/models/AdminConceptDiagram.d.ts

@@ -149,6 +149,12 @@ export interface AdminConceptDiagram {
      * @memberof AdminConceptDiagram
      */
     revisesDiagramId: string | null;
+    /**
+     * The changes an admin asked for when this diagram was revised from the previous version (revisesDiagramId) by editing it, with everything else kept. Null for a fresh diagram and for a regeneration from a rewritten brief.
+     * @type {string}
+     * @memberof AdminConceptDiagram
+     */
+    revisionInstructions: string | null;
     /**
      *
      * @type {string}

package/dist/esm/models/AdminConceptDiagram.js

@@ -76,6 +76,8 @@ export function instanceOfAdminConceptDiagram(value) {
         return false;
     if (!('revisesDiagramId' in value) || value['revisesDiagramId'] === undefined)
         return false;
+    if (!('revisionInstructions' in value) || value['revisionInstructions'] === undefined)
+        return false;
     if (!('title' in value) || value['title'] === undefined)
         return false;
     if (!('effort' in value) || value['effort'] === undefined)
@@ -112,6 +114,7 @@ export function AdminConceptDiagramFromJSONTyped(json, ignoreDiscriminator) {
         'costUsd': json['costUsd'],
         'description': json['description'],
         'revisesDiagramId': json['revisesDiagramId'],
+        'revisionInstructions': json['revisionInstructions'],
         'title': json['title'],
         'effort': json['effort'],
     };
@@ -146,6 +149,7 @@ export function AdminConceptDiagramToJSONTyped(value, ignoreDiscriminator = fals
         'costUsd': value['costUsd'],
         'description': value['description'],
         'revisesDiagramId': value['revisesDiagramId'],
+        'revisionInstructions': value['revisionInstructions'],
         'title': value['title'],
         'effort': value['effort'],
     };

package/dist/esm/models/AdminConceptDiagramDetail.d.ts

@@ -151,6 +151,12 @@ export interface AdminConceptDiagramDetail {
      * @memberof AdminConceptDiagramDetail
      */
     revisesDiagramId: string | null;
+    /**
+     * The changes an admin asked for when this diagram was revised from the previous version (revisesDiagramId) by editing it, with everything else kept. Null for a fresh diagram and for a regeneration from a rewritten brief.
+     * @type {string}
+     * @memberof AdminConceptDiagramDetail
+     */
+    revisionInstructions: string | null;
     /**
      *
      * @type {string}

package/dist/esm/models/AdminConceptDiagramDetail.js

@@ -78,6 +78,8 @@ export function instanceOfAdminConceptDiagramDetail(value) {
         return false;
     if (!('revisesDiagramId' in value) || value['revisesDiagramId'] === undefined)
         return false;
+    if (!('revisionInstructions' in value) || value['revisionInstructions'] === undefined)
+        return false;
     if (!('title' in value) || value['title'] === undefined)
         return false;
     if (!('effort' in value) || value['effort'] === undefined)
@@ -126,6 +128,7 @@ export function AdminConceptDiagramDetailFromJSONTyped(json, ignoreDiscriminator
         'costUsd': json['costUsd'],
         'description': json['description'],
         'revisesDiagramId': json['revisesDiagramId'],
+        'revisionInstructions': json['revisionInstructions'],
         'title': json['title'],
         'effort': json['effort'],
         'brief': json['brief'],
@@ -166,6 +169,7 @@ export function AdminConceptDiagramDetailToJSONTyped(value, ignoreDiscriminator
         'costUsd': value['costUsd'],
         'description': value['description'],
         'revisesDiagramId': value['revisesDiagramId'],
+        'revisionInstructions': value['revisionInstructions'],
         'title': value['title'],
         'effort': value['effort'],
         'brief': value['brief'],