@examplary/sdk 2.14.0 → 2.16.0

package/dist/index.d.mts

@@ -809,6 +809,26 @@ interface paths {
         patch: operations["exams.questions.update"];
         trace?: never;
     };
+    "/exams/{id}/questions/{questionId}/quality": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get question quality score
+         * @description Retrieve the quality score of a question. This is an async endpoint - when called for the first time, it will trigger a quality assessment and return a status of `pending`. Subsequent calls will return the quality score once available. We recommend polling this endpoint every 5-10 seconds until the score is available.
+         */
+        get: operations["exams.questions.getQuality"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/exams/{id}/questions/{questionId}/generate": {
         parameters: {
             query?: never;
@@ -926,7 +946,7 @@ interface paths {
          */
         get: operations["exams.get"];
         put?: never;
-        post: operations["postExams:id"];
+        post?: never;
         /**
          * Delete exam
          * @description Delete the exam.
@@ -1065,6 +1085,34 @@ interface paths {
         patch: operations["me.update"];
         trace?: never;
     };
+    "/me/two-factor": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get two-factor status
+         * @description Check whether two-factor authentication is enabled for the current user, and whether the workspace requires it.
+         */
+        get: operations["me.twoFactor.get"];
+        put?: never;
+        /**
+         * Enable two-factor authentication
+         * @description Turn on two-factor authentication, after an authenticator app has been registered and verified with Cognito.
+         */
+        post: operations["me.twoFactor.enable"];
+        /**
+         * Disable two-factor authentication
+         * @description Turn off two-factor authentication for the current user. Not allowed when the workspace requires it.
+         */
+        delete: operations["me.twoFactor.disable"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/media/upload": {
         parameters: {
             query?: never;
@@ -1139,6 +1187,25 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/org/identity-provider": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get single sign-on configuration */
+        get: operations["org.identityProvider.get"];
+        put?: never;
+        /** Configure single sign-on */
+        post: operations["org.identityProvider.update"];
+        /** Turn off single sign-on */
+        delete: operations["org.identityProvider.delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/orgs": {
         parameters: {
             query?: never;
@@ -1492,6 +1559,26 @@ interface paths {
         patch: operations["users.update"];
         trace?: never;
     };
+    "/users/{id}/two-factor": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Reset two-factor authentication
+         * @description Remove a user's authenticator app, so they can sign in again after losing their device.
+         */
+        delete: operations["users.resetTwoFactor"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/practice-spaces": {
         parameters: {
             query?: never;
@@ -1929,7 +2016,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        post: operations["postFolders:id"];
+        post?: never;
         /**
          * Delete folder
          * @description Delete a folder from the current workspace. If there are any exams in the folder, they will be moved out of the folder.
@@ -2565,6 +2652,8 @@ interface operations {
                     }[];
                     /** @description Whether this question type is public and can be used by all users */
                     public?: boolean;
+                    /** @description Whether this question type is deprecated: existing questions keep working, but no new ones can be added */
+                    deprecated?: boolean;
                     /** @description Custom translations for this question type */
                     translations?: {
                         [key: string]: string | {
@@ -2906,6 +2995,10 @@ interface operations {
                         backgroundColor?: string;
                         /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                         locale?: string;
+                        /** @description Optional overrides for specific UI strings, keyed by string ID */
+                        strings?: {
+                            [key: string]: string;
+                        };
                     };
                     /** @description Additional key-value metadata */
                     metadata?: {
@@ -2934,6 +3027,11 @@ interface operations {
                         language?: string | null;
                         intendedDuration?: unknown | null;
                         allowedGenerationQuestionTypes?: string[] | null;
+                        hideStudentLevel?: boolean | null;
+                        hideSubject?: boolean | null;
+                        hideDuration?: boolean | null;
+                        hideQuestionTypes?: boolean | null;
+                        hideTaxonomy?: boolean | null;
                     };
                 } | {
                     /** @description The user ID for whom the embed session is created */
@@ -2946,6 +3044,10 @@ interface operations {
                         backgroundColor?: string;
                         /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                         locale?: string;
+                        /** @description Optional overrides for specific UI strings, keyed by string ID */
+                        strings?: {
+                            [key: string]: string;
+                        };
                     };
                     /** @description Additional key-value metadata */
                     metadata?: {
@@ -3023,6 +3125,10 @@ interface operations {
                         backgroundColor?: string;
                         /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                         locale?: string;
+                        /** @description Optional overrides for specific UI strings, keyed by string ID */
+                        strings?: {
+                            [key: string]: string;
+                        };
                     };
                     /** @description Additional key-value metadata */
                     metadata?: {
@@ -3063,6 +3169,10 @@ interface operations {
                         backgroundColor?: string;
                         /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                         locale?: string;
+                        /** @description Optional overrides for specific UI strings, keyed by string ID */
+                        strings?: {
+                            [key: string]: string;
+                        };
                     };
                     /** @description Additional key-value metadata */
                     metadata?: {
@@ -3098,6 +3208,10 @@ interface operations {
                         backgroundColor?: string;
                         /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                         locale?: string;
+                        /** @description Optional overrides for specific UI strings, keyed by string ID */
+                        strings?: {
+                            [key: string]: string;
+                        };
                     };
                     /** @description Additional key-value metadata */
                     metadata?: {
@@ -3130,6 +3244,10 @@ interface operations {
                         backgroundColor?: string;
                         /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                         locale?: string;
+                        /** @description Optional overrides for specific UI strings, keyed by string ID */
+                        strings?: {
+                            [key: string]: string;
+                        };
                     };
                     /** @description Additional key-value metadata */
                     metadata?: {
@@ -3162,6 +3280,10 @@ interface operations {
                         backgroundColor?: string;
                         /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                         locale?: string;
+                        /** @description Optional overrides for specific UI strings, keyed by string ID */
+                        strings?: {
+                            [key: string]: string;
+                        };
                     };
                     /** @description Additional key-value metadata */
                     metadata?: {
@@ -3218,6 +3340,10 @@ interface operations {
                             backgroundColor?: string;
                             /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                             locale?: string;
+                            /** @description Optional overrides for specific UI strings, keyed by string ID */
+                            strings?: {
+                                [key: string]: string;
+                            };
                         };
                         metadata: {
                             [key: string]: unknown;
@@ -3269,6 +3395,10 @@ interface operations {
                             backgroundColor?: string;
                             /** @description Locale code for UI language. Currently supported: 'en', 'nl' - other values accepted, but will default to English */
                             locale?: string;
+                            /** @description Optional overrides for specific UI strings, keyed by string ID */
+                            strings?: {
+                                [key: string]: string;
+                            };
                         };
                         metadata: {
                             [key: string]: unknown;
@@ -3354,7 +3484,15 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** Format: uri */
+                    image: string;
+                    questionId?: string | null;
+                };
+            };
+        };
         responses: never;
     };
     "exams.sessions.releaseGrades": {
@@ -3855,6 +3993,46 @@ interface operations {
         };
         responses: never;
     };
+    "exams.questions.getQuality": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Exam ID, e.g. `exam_1234`. */
+                id: string;
+                /** @description Question ID, e.g. `question_1234`, or `first` to get the first question. */
+                questionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Quality score of the specified question. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        status: "pending" | "complete";
+                        checkerVersion?: number;
+                        qualityScore?: number;
+                        timeTakenMs?: number;
+                        totalScorePercentage?: number;
+                        criteria?: {
+                            id: string;
+                            name: string;
+                            description: string;
+                            reasoning?: string;
+                            score?: number;
+                            passed: boolean;
+                        }[];
+                    };
+                };
+            };
+        };
+    };
     "exams.questions.regenerate": {
         parameters: {
             query?: never;
@@ -4079,18 +4257,6 @@ interface operations {
         requestBody?: never;
         responses: never;
     };
-    "postExams:id": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: never;
-    };
     "exams.delete": {
         parameters: {
             query?: never;
@@ -4213,6 +4379,36 @@ interface operations {
         };
         responses: never;
     };
+    "me.twoFactor.get": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: never;
+    };
+    "me.twoFactor.enable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: never;
+    };
+    "me.twoFactor.disable": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: never;
+    };
     "media.upload": {
         parameters: {
             query?: {
@@ -4285,6 +4481,8 @@ interface operations {
                         sharingBlockPublic?: boolean;
                         /** @description Whether the organization blocks teachers from inviting new users. */
                         sharingBlockTeachersInvitingUsers?: boolean;
+                        /** @description Whether members signing in with a password must use two-factor authentication. */
+                        requireTwoFactor?: boolean;
                     };
                 };
             };
@@ -4327,6 +4525,59 @@ interface operations {
         };
         responses: never;
     };
+    "org.identityProvider.get": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: never;
+    };
+    "org.identityProvider.update": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @constant */
+                    providerType: "google";
+                    domain?: string | null;
+                } | {
+                    /** @constant */
+                    providerType: "entree";
+                    externalId: string;
+                } | {
+                    /** @constant */
+                    providerType: "oidc";
+                    oidc: {
+                        /** Format: uri */
+                        issuer: string;
+                        clientId: string;
+                        clientSecret?: string;
+                        /** @default openid profile email */
+                        scopes?: string;
+                    };
+                };
+            };
+        };
+        responses: never;
+    };
+    "org.identityProvider.delete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: never;
+    };
     "orgs.list": {
         parameters: {
             query?: never;
@@ -4902,6 +5153,18 @@ interface operations {
         requestBody?: never;
         responses: never;
     };
+    "users.resetTwoFactor": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: never;
+    };
     "practiceSpaces.list": {
         parameters: {
             query?: {
@@ -5726,24 +5989,6 @@ interface operations {
         };
         responses: never;
     };
-    "postFolders:id": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: {
-            content: {
-                "application/json": {
-                    name: string;
-                };
-            };
-        };
-        responses: never;
-    };
     "folders.delete": {
         parameters: {
             query?: never;
@@ -6701,6 +6946,10 @@ interface _PathOverrides {
         examId: string;
         questionId: string;
     };
+    "exams.questions.getQuality": {
+        examId: string;
+        questionId: string;
+    };
     "exams.questions.regenerate": {
         examId: string;
         questionId: string;
@@ -6717,9 +6966,6 @@ interface _PathOverrides {
     "exams.update": {
         id: string;
     };
-    "postExams:id": {
-        id: string;
-    };
     "exams.delete": {
         id: string;
     };
@@ -6770,6 +7016,9 @@ interface _PathOverrides {
     "users.delete": {
         id: string;
     };
+    "users.resetTwoFactor": {
+        userId: string;
+    };
     "practiceSpaces.get": {
         id: string;
     };
@@ -6838,9 +7087,6 @@ interface _PathOverrides {
     "folders.update": {
         id: string;
     };
-    "postFolders:id": {
-        id: string;
-    };
     "folders.delete": {
         id: string;
     };
@@ -7223,7 +7469,6 @@ declare class ExamsSessions {
      *
      * API endpoint: `POST /exams/{examId}/sessions/scan`
      */
-    scan(examId: string, options?: ExamplaryRequestOptions): Promise<Response<"exams.sessions.scan">>;
     scan(args: Args<"exams.sessions.scan">, options?: ExamplaryRequestOptions): Promise<Response<"exams.sessions.scan">>;
     /**
      * Release grades
@@ -7391,6 +7636,14 @@ declare class ExamsQuestions {
      * API endpoint: `PATCH /exams/{examId}/questions/{questionId}`
      */
     update(args: Args<"exams.questions.update">, options?: ExamplaryRequestOptions): Promise<Response<"exams.questions.update">>;
+    /**
+     * Get question quality score
+     *
+     * Retrieve the quality score of a question. This is an async endpoint - when called for the first time, it will trigger a quality assessment and return a status of `pending`. Subsequent calls will return the quality score once available. We recommend polling this endpoint every 5-10 seconds until the score is available.
+     *
+     * API endpoint: `GET /exams/{examId}/questions/{questionId}/quality`
+     */
+    getQuality(args: Args<"exams.questions.getQuality">, options?: ExamplaryRequestOptions): Promise<Response<"exams.questions.getQuality">>;
     /**
      * Regenerate question
      *
@@ -7524,8 +7777,37 @@ declare class Exams {
     getContextSuggestions(examId: string, options?: ExamplaryRequestOptions): Promise<Response<"exams.getContextSuggestions">>;
     getContextSuggestions(args: Args<"exams.getContextSuggestions">, options?: ExamplaryRequestOptions): Promise<Response<"exams.getContextSuggestions">>;
 }
+declare class MeTwoFactor {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /**
+     * Get two-factor status
+     *
+     * Check whether two-factor authentication is enabled for the current user, and whether the workspace requires it.
+     *
+     * API endpoint: `GET /me/two-factor`
+     */
+    get(args?: Args<"me.twoFactor.get">, options?: ExamplaryRequestOptions): Promise<Response<"me.twoFactor.get">>;
+    /**
+     * Enable two-factor authentication
+     *
+     * Turn on two-factor authentication, after an authenticator app has been registered and verified with Cognito.
+     *
+     * API endpoint: `POST /me/two-factor`
+     */
+    enable(args?: Args<"me.twoFactor.enable">, options?: ExamplaryRequestOptions): Promise<Response<"me.twoFactor.enable">>;
+    /**
+     * Disable two-factor authentication
+     *
+     * Turn off two-factor authentication for the current user. Not allowed when the workspace requires it.
+     *
+     * API endpoint: `DELETE /me/two-factor`
+     */
+    disable(args?: Args<"me.twoFactor.disable">, options?: ExamplaryRequestOptions): Promise<Response<"me.twoFactor.disable">>;
+}
 declare class Me {
     private readonly ctx;
+    readonly twoFactor: MeTwoFactor;
     constructor(ctx: ClientContext);
     /**
      * Get me
@@ -7572,9 +7854,32 @@ declare class OrgCustomDomain {
      */
     update(args?: Args<"org.customDomain.update">, options?: ExamplaryRequestOptions): Promise<Response<"org.customDomain.update">>;
 }
+declare class OrgIdentityProvider {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    /**
+     * Get single sign-on configuration
+     *
+     * API endpoint: `GET /org/identity-provider`
+     */
+    get(args?: Args<"org.identityProvider.get">, options?: ExamplaryRequestOptions): Promise<Response<"org.identityProvider.get">>;
+    /**
+     * Configure single sign-on
+     *
+     * API endpoint: `POST /org/identity-provider`
+     */
+    update(args?: Args<"org.identityProvider.update">, options?: ExamplaryRequestOptions): Promise<Response<"org.identityProvider.update">>;
+    /**
+     * Turn off single sign-on
+     *
+     * API endpoint: `DELETE /org/identity-provider`
+     */
+    delete(args?: Args<"org.identityProvider.delete">, options?: ExamplaryRequestOptions): Promise<Response<"org.identityProvider.delete">>;
+}
 declare class Org {
     private readonly ctx;
     readonly customDomain: OrgCustomDomain;
+    readonly identityProvider: OrgIdentityProvider;
     constructor(ctx: ClientContext);
     /**
      * Get organization
@@ -7835,6 +8140,15 @@ declare class Users {
      */
     delete(id: string, options?: ExamplaryRequestOptions): Promise<Response<"users.delete">>;
     delete(args: Args<"users.delete">, options?: ExamplaryRequestOptions): Promise<Response<"users.delete">>;
+    /**
+     * Reset two-factor authentication
+     *
+     * Remove a user's authenticator app, so they can sign in again after losing their device.
+     *
+     * API endpoint: `DELETE /users/{userId}/two-factor`
+     */
+    resetTwoFactor(userId: string, options?: ExamplaryRequestOptions): Promise<Response<"users.resetTwoFactor">>;
+    resetTwoFactor(args: Args<"users.resetTwoFactor">, options?: ExamplaryRequestOptions): Promise<Response<"users.resetTwoFactor">>;
 }
 declare class PracticeSpacesStudents {
     private readonly ctx;
@@ -8338,15 +8652,6 @@ declare class Examplary {
     readonly prompts: Prompts;
     readonly jobs: Jobs;
     constructor(options: ExamplaryClientOptions);
-    /**
-     * API endpoint: `POST /exams/{id}`
-     */
-    postExamsId(id: string, options?: ExamplaryRequestOptions): Promise<Response<"postExams:id">>;
-    postExamsId(args: Args<"postExams:id">, options?: ExamplaryRequestOptions): Promise<Response<"postExams:id">>;
-    /**
-     * API endpoint: `POST /folders/{id}`
-     */
-    postFoldersId(args: Args<"postFolders:id">, options?: ExamplaryRequestOptions): Promise<Response<"postFolders:id">>;
     /**
      * Get rubrics
      *