@easyedu/js-lsm-api 1.112.0 → 1.113.0

package/README.md

@@ -1,4 +1,4 @@
-# @easyedu/js-lsm-api@1.112.0
+# @easyedu/js-lsm-api@1.113.0
 
 A TypeScript SDK client for the sbzw93t49b.execute-api.us-east-2.amazonaws.com API.
 
@@ -328,8 +328,9 @@ All URIs are relative to *https://sbzw93t49b.execute-api.us-east-2.amazonaws.com
 *QuestionApi* | [**deleteQuestion**](docs/QuestionApi.md#deletequestion) | **DELETE** /questions/{questionId} | Delete a question by ID
 *QuestionApi* | [**getQuestion**](docs/QuestionApi.md#getquestion) | **GET** /questions/{questionId} | Get a question by ID
 *QuestionApi* | [**getQuestionList**](docs/QuestionApi.md#getquestionlist) | **GET** /questions | Get list of questions with filtering and pagination
+*QuestionApi* | [**getQuestionVersions**](docs/QuestionApi.md#getquestionversions) | **GET** /questions/{questionId}/versions | Get all versions of a question
 *QuestionApi* | [**postQuestion**](docs/QuestionApi.md#postquestion) | **POST** /questions | Create a new question
-*QuestionApi* | [**putQuestion**](docs/QuestionApi.md#putquestion) | **PUT** /questions/{questionId} | Update a question by ID
+*QuestionApi* | [**putQuestion**](docs/QuestionApi.md#putquestion) | **PUT** /questions/{questionId} | Create the next version of a question
 *QuestionImportApi* | [**postQuestionImportCommit**](docs/QuestionImportApi.md#postquestionimportcommit) | **POST** /question-imports/commit | Validate and atomically create, version, or skip approved question drafts
 *QuestionImportApi* | [**postQuestionImportParse**](docs/QuestionImportApi.md#postquestionimportparse) | **POST** /question-imports/parse | Parse a question document into stateless review drafts
 *ReportingApi* | [**getCourseVersionReporting**](docs/ReportingApi.md#getcourseversionreporting) | **GET** /courses/{courseId}/versions/{courseVersionId}/reporting | Get instructor reporting for one explicit course version
@@ -701,7 +702,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `1.0.0`
-- Package version: `1.112.0`
+- Package version: `1.113.0`
 - Generator version: `7.22.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/QuestionApi.d.ts

@@ -27,6 +27,9 @@ export interface GetQuestionListRequest {
     tagId?: string;
     search?: string;
 }
+export interface GetQuestionVersionsRequest {
+    questionId: string;
+}
 export interface PostQuestionRequest {
     postQuestion: PostQuestion;
 }
@@ -74,6 +77,18 @@ export declare class QuestionApi extends runtime.BaseAPI {
      * Get list of questions with filtering and pagination
      */
     getQuestionList(requestParameters?: GetQuestionListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetQuestionList>;
+    /**
+     * Creates request options for getQuestionVersions without sending the request
+     */
+    getQuestionVersionsRequestOpts(requestParameters: GetQuestionVersionsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersionsRaw(requestParameters: GetQuestionVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<GetQuestion>>>;
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersions(requestParameters: GetQuestionVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<GetQuestion>>;
     /**
      * Creates request options for postQuestion without sending the request
      */
@@ -91,11 +106,11 @@ export declare class QuestionApi extends runtime.BaseAPI {
      */
     putQuestionRequestOpts(requestParameters: PutQuestionRequest): Promise<runtime.RequestOpts>;
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestionRaw(requestParameters: PutQuestionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetQuestion>>;
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestion(requestParameters: PutQuestionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetQuestion>;
 }

package/dist/apis/QuestionApi.js

@@ -159,6 +159,45 @@ class QuestionApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getQuestionVersions without sending the request
+     */
+    getQuestionVersionsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['questionId'] == null) {
+                throw new runtime.RequiredError('questionId', 'Required parameter "questionId" was null or undefined when calling getQuestionVersions().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            let urlPath = `/questions/{questionId}/versions`;
+            urlPath = urlPath.replace('{questionId}', encodeURIComponent(String(requestParameters['questionId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersionsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getQuestionVersionsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(GetQuestion_1.GetQuestionFromJSON));
+        });
+    }
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersions(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getQuestionVersionsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for postQuestion without sending the request
      */
@@ -225,7 +264,7 @@ class QuestionApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestionRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -235,7 +274,7 @@ class QuestionApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestion(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {

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

@@ -27,6 +27,9 @@ export interface GetQuestionListRequest {
     tagId?: string;
     search?: string;
 }
+export interface GetQuestionVersionsRequest {
+    questionId: string;
+}
 export interface PostQuestionRequest {
     postQuestion: PostQuestion;
 }
@@ -74,6 +77,18 @@ export declare class QuestionApi extends runtime.BaseAPI {
      * Get list of questions with filtering and pagination
      */
     getQuestionList(requestParameters?: GetQuestionListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetQuestionList>;
+    /**
+     * Creates request options for getQuestionVersions without sending the request
+     */
+    getQuestionVersionsRequestOpts(requestParameters: GetQuestionVersionsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersionsRaw(requestParameters: GetQuestionVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<GetQuestion>>>;
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersions(requestParameters: GetQuestionVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<GetQuestion>>;
     /**
      * Creates request options for postQuestion without sending the request
      */
@@ -91,11 +106,11 @@ export declare class QuestionApi extends runtime.BaseAPI {
      */
     putQuestionRequestOpts(requestParameters: PutQuestionRequest): Promise<runtime.RequestOpts>;
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestionRaw(requestParameters: PutQuestionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetQuestion>>;
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestion(requestParameters: PutQuestionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetQuestion>;
 }

package/dist/esm/apis/QuestionApi.js

@@ -156,6 +156,45 @@ export class QuestionApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getQuestionVersions without sending the request
+     */
+    getQuestionVersionsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['questionId'] == null) {
+                throw new runtime.RequiredError('questionId', 'Required parameter "questionId" was null or undefined when calling getQuestionVersions().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            let urlPath = `/questions/{questionId}/versions`;
+            urlPath = urlPath.replace('{questionId}', encodeURIComponent(String(requestParameters['questionId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersionsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getQuestionVersionsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(GetQuestionFromJSON));
+        });
+    }
+    /**
+     * Get all versions of a question
+     */
+    getQuestionVersions(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getQuestionVersionsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for postQuestion without sending the request
      */
@@ -222,7 +261,7 @@ export class QuestionApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestionRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -232,7 +271,7 @@ export class QuestionApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     putQuestion(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {

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

@@ -74,6 +74,18 @@ export interface GetQuestion {
      * @memberof GetQuestion
      */
     readonly versionNumber: number;
+    /**
+     * Whether this is the current editable version in the question history
+     * @type {boolean}
+     * @memberof GetQuestion
+     */
+    readonly isLatestVersion: boolean;
+    /**
+     * Optional note describing why this version was created
+     * @type {string}
+     * @memberof GetQuestion
+     */
+    versionCreatedReason?: string;
     /**
      * When the question was created
      * @type {Date}
@@ -130,4 +142,4 @@ export declare function instanceOfGetQuestion(value: object): value is GetQuesti
 export declare function GetQuestionFromJSON(json: any): GetQuestion;
 export declare function GetQuestionFromJSONTyped(json: any, ignoreDiscriminator: boolean): GetQuestion;
 export declare function GetQuestionToJSON(json: any): GetQuestion;
-export declare function GetQuestionToJSONTyped(value?: Omit<GetQuestion, 'id' | 'version_number' | 'created_date' | 'updated_date' | 'created_by' | 'quiz_count' | 'quizzes'> | null, ignoreDiscriminator?: boolean): any;
+export declare function GetQuestionToJSONTyped(value?: Omit<GetQuestion, 'id' | 'version_number' | 'is_latest_version' | 'created_date' | 'updated_date' | 'created_by' | 'quiz_count' | 'quizzes'> | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/GetQuestion.js

@@ -39,6 +39,8 @@ export function instanceOfGetQuestion(value) {
         return false;
     if (!('versionNumber' in value) || value['versionNumber'] === undefined)
         return false;
+    if (!('isLatestVersion' in value) || value['isLatestVersion'] === undefined)
+        return false;
     if (!('createdDate' in value) || value['createdDate'] === undefined)
         return false;
     if (!('updatedDate' in value) || value['updatedDate'] === undefined)
@@ -62,6 +64,8 @@ export function GetQuestionFromJSONTyped(json, ignoreDiscriminator) {
         'tags': json['tags'] == null ? undefined : (json['tags'].map(ContentLibraryTagFromJSON)),
         'version': json['version'] == null ? undefined : json['version'],
         'versionNumber': json['version_number'],
+        'isLatestVersion': json['is_latest_version'],
+        'versionCreatedReason': json['version_created_reason'] == null ? undefined : json['version_created_reason'],
         'createdDate': (new Date(json['created_date'])),
         'updatedDate': (new Date(json['updated_date'])),
         'createdBy': json['created_by'] == null ? undefined : json['created_by'],
@@ -85,6 +89,7 @@ export function GetQuestionToJSONTyped(value, ignoreDiscriminator = false) {
         'explanation': RichTextDocumentToJSON(value['explanation']),
         'tags': value['tags'] == null ? undefined : (value['tags'].map(ContentLibraryTagToJSON)),
         'version': value['version'],
+        'version_created_reason': value['versionCreatedReason'],
         'import_source': QuestionImportSourceSummaryToJSON(value['importSource']),
     };
 }

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

@@ -59,6 +59,12 @@ export interface PutQuestion {
      * @memberof PutQuestion
      */
     version?: string;
+    /**
+     * Optional note describing the changes in the new version
+     * @type {string}
+     * @memberof PutQuestion
+     */
+    versionReason?: string;
 }
 /**
  * @export

package/dist/esm/models/PutQuestion.js

@@ -45,6 +45,7 @@ export function PutQuestionFromJSONTyped(json, ignoreDiscriminator) {
         'explanation': json['explanation'] == null ? undefined : RichTextInputFromJSON(json['explanation']),
         'tags': json['tags'] == null ? undefined : json['tags'],
         'version': json['version'] == null ? undefined : json['version'],
+        'versionReason': json['version_reason'] == null ? undefined : json['version_reason'],
     };
 }
 export function PutQuestionToJSON(json) {
@@ -62,5 +63,6 @@ export function PutQuestionToJSONTyped(value, ignoreDiscriminator = false) {
         'explanation': RichTextInputToJSON(value['explanation']),
         'tags': value['tags'],
         'version': value['version'],
+        'version_reason': value['versionReason'],
     };
 }

package/dist/models/GetQuestion.d.ts

@@ -74,6 +74,18 @@ export interface GetQuestion {
      * @memberof GetQuestion
      */
     readonly versionNumber: number;
+    /**
+     * Whether this is the current editable version in the question history
+     * @type {boolean}
+     * @memberof GetQuestion
+     */
+    readonly isLatestVersion: boolean;
+    /**
+     * Optional note describing why this version was created
+     * @type {string}
+     * @memberof GetQuestion
+     */
+    versionCreatedReason?: string;
     /**
      * When the question was created
      * @type {Date}
@@ -130,4 +142,4 @@ export declare function instanceOfGetQuestion(value: object): value is GetQuesti
 export declare function GetQuestionFromJSON(json: any): GetQuestion;
 export declare function GetQuestionFromJSONTyped(json: any, ignoreDiscriminator: boolean): GetQuestion;
 export declare function GetQuestionToJSON(json: any): GetQuestion;
-export declare function GetQuestionToJSONTyped(value?: Omit<GetQuestion, 'id' | 'version_number' | 'created_date' | 'updated_date' | 'created_by' | 'quiz_count' | 'quizzes'> | null, ignoreDiscriminator?: boolean): any;
+export declare function GetQuestionToJSONTyped(value?: Omit<GetQuestion, 'id' | 'version_number' | 'is_latest_version' | 'created_date' | 'updated_date' | 'created_by' | 'quiz_count' | 'quizzes'> | null, ignoreDiscriminator?: boolean): any;

package/dist/models/GetQuestion.js

@@ -47,6 +47,8 @@ function instanceOfGetQuestion(value) {
         return false;
     if (!('versionNumber' in value) || value['versionNumber'] === undefined)
         return false;
+    if (!('isLatestVersion' in value) || value['isLatestVersion'] === undefined)
+        return false;
     if (!('createdDate' in value) || value['createdDate'] === undefined)
         return false;
     if (!('updatedDate' in value) || value['updatedDate'] === undefined)
@@ -70,6 +72,8 @@ function GetQuestionFromJSONTyped(json, ignoreDiscriminator) {
         'tags': json['tags'] == null ? undefined : (json['tags'].map(ContentLibraryTag_1.ContentLibraryTagFromJSON)),
         'version': json['version'] == null ? undefined : json['version'],
         'versionNumber': json['version_number'],
+        'isLatestVersion': json['is_latest_version'],
+        'versionCreatedReason': json['version_created_reason'] == null ? undefined : json['version_created_reason'],
         'createdDate': (new Date(json['created_date'])),
         'updatedDate': (new Date(json['updated_date'])),
         'createdBy': json['created_by'] == null ? undefined : json['created_by'],
@@ -93,6 +97,7 @@ function GetQuestionToJSONTyped(value, ignoreDiscriminator = false) {
         'explanation': (0, RichTextDocument_1.RichTextDocumentToJSON)(value['explanation']),
         'tags': value['tags'] == null ? undefined : (value['tags'].map(ContentLibraryTag_1.ContentLibraryTagToJSON)),
         'version': value['version'],
+        'version_created_reason': value['versionCreatedReason'],
         'import_source': (0, QuestionImportSourceSummary_1.QuestionImportSourceSummaryToJSON)(value['importSource']),
     };
 }

package/dist/models/PutQuestion.d.ts

@@ -59,6 +59,12 @@ export interface PutQuestion {
      * @memberof PutQuestion
      */
     version?: string;
+    /**
+     * Optional note describing the changes in the new version
+     * @type {string}
+     * @memberof PutQuestion
+     */
+    versionReason?: string;
 }
 /**
  * @export

package/dist/models/PutQuestion.js

@@ -53,6 +53,7 @@ function PutQuestionFromJSONTyped(json, ignoreDiscriminator) {
         'explanation': json['explanation'] == null ? undefined : (0, RichTextInput_1.RichTextInputFromJSON)(json['explanation']),
         'tags': json['tags'] == null ? undefined : json['tags'],
         'version': json['version'] == null ? undefined : json['version'],
+        'versionReason': json['version_reason'] == null ? undefined : json['version_reason'],
     };
 }
 function PutQuestionToJSON(json) {
@@ -70,5 +71,6 @@ function PutQuestionToJSONTyped(value, ignoreDiscriminator = false) {
         'explanation': (0, RichTextInput_1.RichTextInputToJSON)(value['explanation']),
         'tags': value['tags'],
         'version': value['version'],
+        'version_reason': value['versionReason'],
     };
 }

package/docs/GetQuestion.md

@@ -15,6 +15,8 @@ Name | Type
 `tags` | [Array<ContentLibraryTag>](ContentLibraryTag.md)
 `version` | string
 `versionNumber` | number
+`isLatestVersion` | boolean
+`versionCreatedReason` | string
 `createdDate` | Date
 `updatedDate` | Date
 `createdBy` | string
@@ -38,6 +40,8 @@ const example = {
   "tags": null,
   "version": null,
   "versionNumber": null,
+  "isLatestVersion": null,
+  "versionCreatedReason": null,
   "createdDate": null,
   "updatedDate": null,
   "createdBy": null,

package/docs/PutQuestion.md

@@ -13,6 +13,7 @@ Name | Type
 `explanation` | [RichTextInput](RichTextInput.md)
 `tags` | Array<string>
 `version` | string
+`versionReason` | string
 
 ## Example
 
@@ -28,6 +29,7 @@ const example = {
   "explanation": null,
   "tags": null,
   "version": null,
+  "versionReason": null,
 } satisfies PutQuestion
 
 console.log(example)

package/docs/QuestionApi.md

@@ -7,8 +7,9 @@ All URIs are relative to *https://sbzw93t49b.execute-api.us-east-2.amazonaws.com
 | [**deleteQuestion**](QuestionApi.md#deletequestion) | **DELETE** /questions/{questionId} | Delete a question by ID |
 | [**getQuestion**](QuestionApi.md#getquestion) | **GET** /questions/{questionId} | Get a question by ID |
 | [**getQuestionList**](QuestionApi.md#getquestionlist) | **GET** /questions | Get list of questions with filtering and pagination |
+| [**getQuestionVersions**](QuestionApi.md#getquestionversions) | **GET** /questions/{questionId}/versions | Get all versions of a question |
 | [**postQuestion**](QuestionApi.md#postquestion) | **POST** /questions | Create a new question |
-| [**putQuestion**](QuestionApi.md#putquestion) | **PUT** /questions/{questionId} | Update a question by ID |
+| [**putQuestion**](QuestionApi.md#putquestion) | **PUT** /questions/{questionId} | Create the next version of a question |
 
 
 
@@ -222,6 +223,72 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getQuestionVersions
+
+> Array<GetQuestion> getQuestionVersions(questionId)
+
+Get all versions of a question
+
+### Example
+
+```ts
+import {
+  Configuration,
+  QuestionApi,
+} from '@easyedu/js-lsm-api';
+import type { GetQuestionVersionsRequest } from '@easyedu/js-lsm-api';
+
+async function example() {
+  console.log("🚀 Testing @easyedu/js-lsm-api SDK...");
+  const api = new QuestionApi();
+
+  const body = {
+    // string
+    questionId: questionId_example,
+  } satisfies GetQuestionVersionsRequest;
+
+  try {
+    const data = await api.getQuestionVersions(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **questionId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**Array<GetQuestion>**](GetQuestion.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Question version history, newest first |  -  |
+| **404** | question not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## postQuestion
 
 > GetQuestion postQuestion(postQuestion)
@@ -292,7 +359,7 @@ No authorization required
 
 > GetQuestion putQuestion(questionId, putQuestion)
 
-Update a question by ID
+Create the next version of a question
 
 ### Example
 
@@ -354,6 +421,7 @@ No authorization required
 | **200** | update question response OK |  -  |
 | **404** | question not found |  -  |
 | **400** | update question response error |  -  |
+| **409** | supplied question is a historical or stale version |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easyedu/js-lsm-api",
-  "version": "1.112.0",
+  "version": "1.113.0",
   "description": "OpenAPI client for @easyedu/js-lsm-api",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/QuestionApi.ts

@@ -50,6 +50,10 @@ export interface GetQuestionListRequest {
     search?: string;
 }
 
+export interface GetQuestionVersionsRequest {
+    questionId: string;
+}
+
 export interface PostQuestionRequest {
     postQuestion: PostQuestion;
 }
@@ -210,6 +214,51 @@ export class QuestionApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for getQuestionVersions without sending the request
+     */
+    async getQuestionVersionsRequestOpts(requestParameters: GetQuestionVersionsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['questionId'] == null) {
+            throw new runtime.RequiredError(
+                'questionId',
+                'Required parameter "questionId" was null or undefined when calling getQuestionVersions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/questions/{questionId}/versions`;
+        urlPath = urlPath.replace('{questionId}', encodeURIComponent(String(requestParameters['questionId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Get all versions of a question
+     */
+    async getQuestionVersionsRaw(requestParameters: GetQuestionVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<GetQuestion>>> {
+        const requestOptions = await this.getQuestionVersionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(GetQuestionFromJSON));
+    }
+
+    /**
+     * Get all versions of a question
+     */
+    async getQuestionVersions(requestParameters: GetQuestionVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<GetQuestion>> {
+        const response = await this.getQuestionVersionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for postQuestion without sending the request
      */
@@ -295,7 +344,7 @@ export class QuestionApi extends runtime.BaseAPI {
     }
 
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     async putQuestionRaw(requestParameters: PutQuestionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetQuestion>> {
         const requestOptions = await this.putQuestionRequestOpts(requestParameters);
@@ -305,7 +354,7 @@ export class QuestionApi extends runtime.BaseAPI {
     }
 
     /**
-     * Update a question by ID
+     * Create the next version of a question
      */
     async putQuestion(requestParameters: PutQuestionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetQuestion> {
         const response = await this.putQuestionRaw(requestParameters, initOverrides);

package/src/models/GetQuestion.ts

@@ -109,6 +109,18 @@ export interface GetQuestion {
      * @memberof GetQuestion
      */
     readonly versionNumber: number;
+    /**
+     * Whether this is the current editable version in the question history
+     * @type {boolean}
+     * @memberof GetQuestion
+     */
+    readonly isLatestVersion: boolean;
+    /**
+     * Optional note describing why this version was created
+     * @type {string}
+     * @memberof GetQuestion
+     */
+    versionCreatedReason?: string;
     /**
      * When the question was created
      * @type {Date}
@@ -170,6 +182,7 @@ export function instanceOfGetQuestion(value: object): value is GetQuestion {
     if (!('questionText' in value) || value['questionText'] === undefined) return false;
     if (!('questionType' in value) || value['questionType'] === undefined) return false;
     if (!('versionNumber' in value) || value['versionNumber'] === undefined) return false;
+    if (!('isLatestVersion' in value) || value['isLatestVersion'] === undefined) return false;
     if (!('createdDate' in value) || value['createdDate'] === undefined) return false;
     if (!('updatedDate' in value) || value['updatedDate'] === undefined) return false;
     return true;
@@ -194,6 +207,8 @@ export function GetQuestionFromJSONTyped(json: any, ignoreDiscriminator: boolean
         'tags': json['tags'] == null ? undefined : ((json['tags'] as Array<any>).map(ContentLibraryTagFromJSON)),
         'version': json['version'] == null ? undefined : json['version'],
         'versionNumber': json['version_number'],
+        'isLatestVersion': json['is_latest_version'],
+        'versionCreatedReason': json['version_created_reason'] == null ? undefined : json['version_created_reason'],
         'createdDate': (new Date(json['created_date'])),
         'updatedDate': (new Date(json['updated_date'])),
         'createdBy': json['created_by'] == null ? undefined : json['created_by'],
@@ -207,7 +222,7 @@ export function GetQuestionToJSON(json: any): GetQuestion {
     return GetQuestionToJSONTyped(json, false);
 }
 
-export function GetQuestionToJSONTyped(value?: Omit<GetQuestion, 'id'|'version_number'|'created_date'|'updated_date'|'created_by'|'quiz_count'|'quizzes'> | null, ignoreDiscriminator: boolean = false): any {
+export function GetQuestionToJSONTyped(value?: Omit<GetQuestion, 'id'|'version_number'|'is_latest_version'|'created_date'|'updated_date'|'created_by'|'quiz_count'|'quizzes'> | null, ignoreDiscriminator: boolean = false): any {
     if (value == null) {
         return value;
     }
@@ -221,6 +236,7 @@ export function GetQuestionToJSONTyped(value?: Omit<GetQuestion, 'id'|'version_n
         'explanation': RichTextDocumentToJSON(value['explanation']),
         'tags': value['tags'] == null ? undefined : ((value['tags'] as Array<any>).map(ContentLibraryTagToJSON)),
         'version': value['version'],
+        'version_created_reason': value['versionCreatedReason'],
         'import_source': QuestionImportSourceSummaryToJSON(value['importSource']),
     };
 }

package/src/models/PutQuestion.ts

@@ -76,6 +76,12 @@ export interface PutQuestion {
      * @memberof PutQuestion
      */
     version?: string;
+    /**
+     * Optional note describing the changes in the new version
+     * @type {string}
+     * @memberof PutQuestion
+     */
+    versionReason?: string;
 }
 
 
@@ -117,6 +123,7 @@ export function PutQuestionFromJSONTyped(json: any, ignoreDiscriminator: boolean
         'explanation': json['explanation'] == null ? undefined : RichTextInputFromJSON(json['explanation']),
         'tags': json['tags'] == null ? undefined : json['tags'],
         'version': json['version'] == null ? undefined : json['version'],
+        'versionReason': json['version_reason'] == null ? undefined : json['version_reason'],
     };
 }
 
@@ -138,6 +145,7 @@ export function PutQuestionToJSONTyped(value?: PutQuestion | null, ignoreDiscrim
         'explanation': RichTextInputToJSON(value['explanation']),
         'tags': value['tags'],
         'version': value['version'],
+        'version_reason': value['versionReason'],
     };
 }