@wix/auto_sdk_online-programs_quizzes 1.0.26 → 1.0.28

package/build/internal/cjs/index.d.ts

@@ -1,56 +1,90 @@
 import { HttpClient, NonNullablePaths, MaybeContext, BuildRESTFunction } from '@wix/sdk-types';
-import { Quiz, CloneQuizResponse, BulkCreateQuizzesOptions, BulkCreateQuizzesResponse, DeleteQuizResponse, BulkDeleteQuizzesResponse } from './index.typings.js';
+import { Quiz, CreateQuizApplicationErrors, CloneQuizResponse, CloneQuizApplicationErrors, BulkCreateQuizzesOptions, BulkCreateQuizzesResponse, BulkCreateQuizzesApplicationErrors, GetQuizApplicationErrors, DeleteQuizResponse, DeleteQuizApplicationErrors, BulkDeleteQuizzesResponse } from './index.typings.js';
 export { AccountInfo, ActionEvent, ApplicationError, BulkActionMetadata, BulkCloneQuizzesRequest, BulkCloneQuizzesResponse, BulkCreateQuizzesRequest, BulkCreateQuizzesResponseBulkQuizResult, BulkDeleteQuizzesRequest, BulkDeleteQuizzesResponseBulkQuizResult, BulkQuizResult, CloneQuizRequest, CreateQuizRequest, CreateQuizResponse, DeleteQuizRequest, DomainEvent, DomainEventBodyOneOf, EntityCreatedEvent, EntityDeletedEvent, EntityUpdatedEvent, FileUploadField, FileUploadFormat, FileUploadFormatWithLiterals, GetQuizRequest, GetQuizResponse, IdentificationData, IdentificationDataIdOneOf, ItemMetadata, LongTextField, MessageEnvelope, MultiChoiceField, NumericField, QuizField, QuizFieldFieldTypeOneOf, QuizSettings, RestoreInfo, ShortTextField, SingleChoiceField, WebhookIdentityType, WebhookIdentityTypeWithLiterals } from './index.typings.js';
 
 declare function createQuiz$1(httpClient: HttpClient): CreateQuizSignature;
 interface CreateQuizSignature {
     /**
-     * Creates quiz
-     * @param - Quiz to created
-     * @returns Created quiz
+     * Creates a detached quiz definition with at least one question.
+     *
+     * To use the quiz in an Online Program, pass the returned quiz ID as `step.quizOptions.id` when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
+     * @param - Quiz definition to create. Generate a stable unique GUID for every `quiz.fields.id` value.
+     * @returns Created quiz definition. Assign its `id` to `step.quizOptions.id` to create an Online Programs quiz step.
      */
-    (quiz: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2>>;
+    (quiz: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2> & {
+        __applicationErrorsType?: CreateQuizApplicationErrors;
+    }>;
 }
 declare function cloneQuiz$1(httpClient: HttpClient): CloneQuizSignature;
 interface CloneQuizSignature {
     /**
-     * Clones quiz
-     * @param - ID of the quiz to be cloned
+     * Clones a quiz definition and returns a new quiz ID.
+     *
+     * Checks the source before cloning. An existing definition found to have no active questions is rejected with INVALID_QUIZ before cloning. Source checks aren't atomic with cloning.
+     *
+     * This operation copies the question and settings definition only. It doesn't copy Online Programs step associations or quiz submissions. Attach the returned ID to a step separately when needed.
+     * @param - ID of the quiz definition to clone.
      */
-    (quizId: string): Promise<NonNullablePaths<CloneQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3>>;
+    (quizId: string): Promise<NonNullablePaths<CloneQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3> & {
+        __applicationErrorsType?: CloneQuizApplicationErrors;
+    }>;
 }
 declare function bulkCreateQuizzes$1(httpClient: HttpClient): BulkCreateQuizzesSignature;
 interface BulkCreateQuizzesSignature {
     /**
-     * Creates up to 30 quiz definitions in a single API call.
+     * Creates up to 30 detached quiz definitions in a single API call. Each definition must contain at least one question.
+     *
+     * Quiz IDs, revisions, and creation and update timestamps are assigned by the server. Client-supplied values for these read-only fields are ignored. Question IDs (`quizzes.fields.id`) must be supplied by the caller.
+     *
+     * Invalid quiz definitions fail the entire request before any quizzes are created.
+     *
+     * Individual item failures don't fail the bulk request. For each failed item, `results.itemMetadata.error` contains the original application error from the Wix Forms operation.
+     *
+     * To use the quizzes in an Online Program, pass the returned quiz IDs as `step.quizOptions.id` values when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
      * @param - Quiz definitions to create.
      */
-    (quizzes: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>[], options?: BulkCreateQuizzesOptions): Promise<NonNullablePaths<BulkCreateQuizzesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4>>;
+    (quizzes: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>[], options?: BulkCreateQuizzesOptions): Promise<NonNullablePaths<BulkCreateQuizzesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4> & {
+        __applicationErrorsType?: BulkCreateQuizzesApplicationErrors;
+    }>;
 }
 declare function getQuiz$1(httpClient: HttpClient): GetQuizSignature;
 interface GetQuizSignature {
     /**
-     * Reads quiz by ID
-     * @param - ID of the quiz
-     * @returns Requested quiz
+     * Retrieves a quiz definition by ID. A stored definition whose questions have all been deleted can be returned with no active questions.
+     *
+     * To discover a quiz ID, query or retrieve its quiz-type Online Programs step and read `step.quizOptions.id`.
+     * @param - Quiz ID, available from `step.quizOptions.id` on a quiz-type Online Programs step.
+     * @returns Requested quiz definition.
      */
-    (quizId: string): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2>>;
+    (quizId: string): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2> & {
+        __applicationErrorsType?: GetQuizApplicationErrors;
+    }>;
 }
 declare function deleteQuiz$1(httpClient: HttpClient): DeleteQuizSignature;
 interface DeleteQuizSignature {
     /**
-     * Deletes quiz
-     * @param - ID of quiz
+     * Permanently deletes a quiz definition.
+     *
+     * This operation doesn't check whether Online Programs steps reference the quiz. Coordinate deletion with the Steps API and remove known step references first. Otherwise, steps can retain dangling quiz references.
+     *
+     * NOT-PRECEDENT: This caller-responsibility behavior is retained as a production v1 compatibility exception. New delete APIs should provide an authoritative server-side reference safeguard.
+     * @param - ID of the quiz definition to permanently delete.
      */
-    (quizId: string): Promise<NonNullablePaths<DeleteQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3>>;
+    (quizId: string): Promise<NonNullablePaths<DeleteQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3> & {
+        __applicationErrorsType?: DeleteQuizApplicationErrors;
+    }>;
 }
 declare function bulkDeleteQuizzes$1(httpClient: HttpClient): BulkDeleteQuizzesSignature;
 interface BulkDeleteQuizzesSignature {
     /**
      * Permanently deletes up to 100 quiz definitions.
      *
-     * This operation doesn't check whether Online Programs steps reference the quizzes. Callers must remove or verify those references before deleting.
-     * @param - IDs of the quizzes to delete.
+     * Individual item failures don't fail the bulk request. For each failed item, `results.itemMetadata.error` contains the original application error from the Wix Forms operation.
+     *
+     * This operation doesn't check whether Online Programs steps reference the quizzes. Coordinate deletion with the Steps API and remove known step references first. Otherwise, steps can retain dangling quiz references.
+     *
+     * NOT-PRECEDENT: This caller-responsibility behavior is retained as a production v1 compatibility exception. New bulk-delete APIs should provide an authoritative server-side reference safeguard.
+     * @param - IDs of the quiz definitions to permanently delete. Coordinate deletion with the Steps API and remove known step references first.
      */
     (quizIds: string[]): Promise<NonNullablePaths<BulkDeleteQuizzesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4>>;
 }
@@ -62,4 +96,4 @@ declare const getQuiz: MaybeContext<BuildRESTFunction<typeof getQuiz$1> & typeof
 declare const deleteQuiz: MaybeContext<BuildRESTFunction<typeof deleteQuiz$1> & typeof deleteQuiz$1>;
 declare const bulkDeleteQuizzes: MaybeContext<BuildRESTFunction<typeof bulkDeleteQuizzes$1> & typeof bulkDeleteQuizzes$1>;
 
-export { BulkCreateQuizzesOptions, BulkCreateQuizzesResponse, BulkDeleteQuizzesResponse, CloneQuizResponse, DeleteQuizResponse, Quiz, bulkCreateQuizzes, bulkDeleteQuizzes, cloneQuiz, createQuiz, deleteQuiz, getQuiz };
+export { BulkCreateQuizzesApplicationErrors, BulkCreateQuizzesOptions, BulkCreateQuizzesResponse, BulkDeleteQuizzesResponse, CloneQuizApplicationErrors, CloneQuizResponse, CreateQuizApplicationErrors, DeleteQuizApplicationErrors, DeleteQuizResponse, GetQuizApplicationErrors, Quiz, bulkCreateQuizzes, bulkDeleteQuizzes, cloneQuiz, createQuiz, deleteQuiz, getQuiz };

package/build/internal/cjs/index.typings.d.ts

@@ -1,31 +1,42 @@
 import { NonNullablePaths } from '@wix/sdk-types';
 
+/**
+ * A quiz definition used by an Online Programs quiz step.
+ *
+ * Create or clone a quiz, then assign the returned quiz ID to `step.quizOptions.id` when creating an Online Programs step. Quiz IDs are intentionally discovered through quiz-type steps rather than through a Quiz list or query method.
+ *
+ * New submissions are evaluated against the quiz definition that exists when the submission is created. Previously stored submissions retain their recorded grades and answer evaluations if the definition changes later.
+ *
+ * NOT-PRECEDENT: The production v1 entity retains its legacy `wix.achievements.quizzes.v1.quiz` identity for compatibility. The Online Programs placement and workflow described here provide its public product context.
+ */
 interface Quiz {
     /**
-     * ID of the quiz
+     * Quiz ID.
      * @format GUID
      * @readonly
      */
     _id?: string | null;
-    /** Quiz settings */
+    /** Quiz title, passing grade, and attempt limit. New submissions use the current settings; stored submissions retain their recorded grade data. */
     settings?: QuizSettings;
     /**
-     * Represents the current state of the quiz. Each time the it is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision
+     * Current revision of the stored quiz definition. The revision changes when the definition changes. The public Quiz API doesn't currently provide an update method.
      * @readonly
      */
     revision?: string | null;
     /**
-     * The time this quiz was created
+     * Date and time the quiz was created.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * The time this quiz was last updated
+     * Date and time the quiz was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
     /**
-     * Quiz fields
+     * Active questions in the quiz. Each `QuizField` defines one question and its answer input. Creating a quiz requires at least one question. An existing definition can have no active questions after its questions are deleted through another supported workflow; retrieving that definition doesn't fail solely because this list is empty.
+     *
+     * New submissions use the current questions; stored submissions retain their recorded answer evaluations. Reading an empty definition doesn't imply that it can be used to create a new quiz or accept submissions.
      * @minSize 1
      * @maxSize 200
      */
@@ -33,119 +44,130 @@ interface Quiz {
 }
 interface QuizSettings {
     /**
-     * Minimal grade to pass the quiz
+     * Minimum unweighted integer percentage required to pass, from `0` through `100`. The earned grade is calculated as `floor((correct answer count / submitted answer count) * 100)`; question `score` values don't weight it. Non-evaluable answers count as correct. If omitted, the submission has no earned or passing grade and its status is COMPLETED, even if an individual evaluated answer is incorrect.
      * @max 100
      */
     passingGrade?: number | null;
     /**
-     * Quiz title
+     * Quiz title.
      * @maxLength 200
      */
     title?: string | null;
     /**
-     * Maximal number of submission attempts
+     * Maximum number of submissions allowed per submitter. If omitted, no attempt-limit check is applied. With `groupId`, the count uses group ID and submitter ID without filtering by quiz ID; otherwise, it uses quiz ID and submitter ID. Reusing a group ID across quizzes shares their attempt count.
      * @min 1
      */
     attempts?: number | null;
 }
+/** Defines one quiz question and its answer input. */
 interface QuizField extends QuizFieldFieldTypeOneOf {
-    /** Type for numeric input */
+    /** Numeric input. */
     numeric?: NumericField;
-    /** Type for text input */
+    /** Short-text input. */
     shortText?: ShortTextField;
-    /** Type for long text input */
+    /** Long-text input. Set this to an empty object (`{}`) to select it. */
     longText?: LongTextField;
-    /** Type for input with predefined options where only one can be selected */
+    /** Input with predefined options where only one option can be selected. */
     singleChoice?: SingleChoiceField;
-    /** Type for input with predefined options where multiple can be selected */
+    /** Input with predefined options where multiple options can be selected. */
     multiChoice?: MultiChoiceField;
-    /** Type for file input */
+    /** File-upload input. */
     fileUpload?: FileUploadField;
     /**
-     * Field ID
+     * Caller-generated GUID that identifies this question. Use a stable value that is unique within the quiz. Submission answer evaluations use this ID to identify the question.
      * @format GUID
      * @immutable
      */
     _id?: string;
     /**
-     * Key used in submission
+     * Stable key used to match a submitted answer to this question. Use a value that is unique within the quiz and don't change or reuse it for another question.
      * @maxLength 200
      * @immutable
      */
     target?: string | null;
     /**
-     * Question
+     * Question text.
      * @minLength 1
      * @maxLength 350
      */
     question?: string | null;
-    /** Score of the question when answered right */
+    /** Score returned for evaluable answers, whether correct or incorrect. Omitted from non-evaluable answer evaluations. This value doesn't weight the submission's unweighted `earnedGrade` percentage. */
     score?: number | null;
     /**
-     * Message shown for right answer
+     * Feedback returned when an evaluable submitted answer is correct. Omitted for non-evaluable answers.
      * @maxLength 350
      */
     rightMessage?: string | null;
     /**
-     * Message shown for wrong answer
+     * Feedback returned when an evaluable submitted answer is incorrect. Omitted for non-evaluable answers.
      * @maxLength 350
      */
     wrongMessage?: string | null;
 }
 /** @oneof */
 interface QuizFieldFieldTypeOneOf {
-    /** Type for numeric input */
+    /** Numeric input. */
     numeric?: NumericField;
-    /** Type for text input */
+    /** Short-text input. */
     shortText?: ShortTextField;
-    /** Type for long text input */
+    /** Long-text input. Set this to an empty object (`{}`) to select it. */
     longText?: LongTextField;
-    /** Type for input with predefined options where only one can be selected */
+    /** Input with predefined options where only one option can be selected. */
     singleChoice?: SingleChoiceField;
-    /** Type for input with predefined options where multiple can be selected */
+    /** Input with predefined options where multiple options can be selected. */
     multiChoice?: MultiChoiceField;
-    /** Type for file input */
+    /** File-upload input. */
     fileUpload?: FileUploadField;
 }
+/** File categories used by Wix Forms. Categories don't define a custom extension or MIME-type allowlist; accepted file types are controlled by Wix Forms. See [About form fields](https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/about-form-fields). */
 declare enum FileUploadFormat {
-    /** Image files. */
+    /** Image-file category. */
     IMAGE = "IMAGE",
-    /** Video files. */
+    /** Video-file category. */
     VIDEO = "VIDEO",
-    /** Audio files. */
+    /** Audio-file category. */
     AUDIO = "AUDIO",
-    /** Document files. */
+    /** Document-file category. */
     DOCUMENT = "DOCUMENT",
-    /** Archive files. */
+    /** Archive-file category. */
     ARCHIVE = "ARCHIVE",
-    /** 3D model files. */
+    /** 3D-model-file category. */
     MODEL_3D = "MODEL_3D"
 }
 /** @enumType */
 type FileUploadFormatWithLiterals = FileUploadFormat | 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE' | 'MODEL_3D';
 interface NumericField {
-    /** Right answer */
+    /**
+     * Correct numeric value. Matching is exact. If no correct value is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct value is stored.
+     */
     rightAnswer?: number | null;
 }
 interface ShortTextField {
     /**
-     * Right answer
+     * Correct text. Matching trims leading and trailing whitespace and is case-insensitive. If no correct text is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct text is stored.
      * @minLength 1
      * @maxLength 200
      */
     rightAnswer?: string | null;
 }
+/** Long-text input settings. Set `longText` to an empty object (`{}`) to select this input. Long-text answers aren't evaluated and count as correct when calculating the earned grade. */
 interface LongTextField {
 }
 interface SingleChoiceField {
     /**
-     * Right answer
+     * Correct option. When supplied, it must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers is exact. If no correct option is stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Omitted from responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove the stored key or change grading; an absent response value doesn't mean no correct option is stored.
      * @minLength 1
      * @maxLength 350
      */
     rightAnswer?: string | null;
     /**
-     * Answer options
+     * Options available to the participant. Labels must be unique; comparison is case-sensitive. Duplicate labels are rejected with INVALID_QUIZ before creation.
      * @minSize 1
      * @maxSize 90
      * @minLength 1
@@ -153,17 +175,19 @@ interface SingleChoiceField {
      */
     options?: string[] | null;
 }
+/** Multiple-choice input settings. Existing Wix Forms image-choice questions are also returned in this shape, even when their original settings allow only one selection. Image-choice-specific settings aren't exposed by the Quiz API. */
 interface MultiChoiceField {
     /**
-     * Returned only with achievements:quizzes:v1:quiz:read_sensitive_fields permission.
-     * Repeated fields cannot use conditional annotations; the service redacts this field.
+     * Correct options. Every supplied value must exactly match an entry in `options`; otherwise, creation fails with INVALID_QUIZ. Matching submitted answers ignores option order but doesn't ignore duplicate values. If no correct options are stored for this question, its submitted answer is non-evaluable and counts as correct when calculating the earned grade.
+     *
+     * Empty in responses when the caller lacks achievements:quizzes:v1:quiz:read_sensitive_fields permission. Response filtering doesn't remove stored keys or change grading; an empty response list doesn't mean no correct options are stored.
      * @maxSize 90
      * @minLength 1
      * @maxLength 350
      */
     rightAnswer?: string[] | null;
     /**
-     * Answer options
+     * Options available to the participant.
      * @minSize 1
      * @maxSize 90
      * @minLength 1
@@ -173,42 +197,42 @@ interface MultiChoiceField {
 }
 interface FileUploadField {
     /**
-     * Text for upload button
+     * Text displayed on the upload button. Default: `Upload`.
      * @minLength 1
      * @maxLength 100
      */
     buttonText?: string | null;
     /**
-     * Limit of upload items
+     * Maximum number of files a participant can upload for this question, from `1` through `10`. Default: `10`.
      * @min 1
      * @max 10
      */
     itemsLimit?: number | null;
     /**
-     * Formats of files that can be uploaded.
+     * Wix Forms file categories that participants can upload.
      *
-     * Specify at least one format. `UNKNOWN_FILE_UPLOAD_FORMAT` isn't supported as a format selection.
+     * Specify at least one format. `UNKNOWN_FILE_UPLOAD_FORMAT` isn't supported as a format selection. File-upload answers aren't evaluated and count as correct when calculating the earned grade.
      * @maxSize 6
      */
     fileUploadFormats?: FileUploadFormatWithLiterals[];
 }
 interface CreateQuizRequest {
-    /** Quiz to created */
+    /** Quiz definition to create. Generate a stable unique GUID for every `quiz.fields.id` value. */
     quiz: Quiz;
 }
 interface CreateQuizResponse {
-    /** Created quiz */
+    /** Created quiz definition. Assign its `id` to `step.quizOptions.id` to create an Online Programs quiz step. */
     quiz?: Quiz;
 }
 interface CloneQuizRequest {
     /**
-     * ID of the quiz to be cloned
+     * ID of the quiz definition to clone.
      * @format GUID
      */
     quizId: string;
 }
 interface CloneQuizResponse {
-    /** Cloned quiz */
+    /** Cloned quiz definition with a new ID. Step associations and submissions aren't cloned. */
     quiz?: Quiz;
 }
 interface BulkCreateQuizzesRequest {
@@ -254,7 +278,7 @@ interface ApplicationError {
     data?: Record<string, any> | null;
 }
 interface BulkCreateQuizzesResponseBulkQuizResult {
-    /** Metadata for the individual create operation. */
+    /** Metadata for the individual create operation. When the operation fails, `error` contains the original Wix Forms application error. */
     itemMetadata?: ItemMetadata;
     /** Created quiz. Empty when `return_entity` is `false`. */
     item?: Quiz;
@@ -296,29 +320,29 @@ interface BulkQuizResult {
 }
 interface GetQuizRequest {
     /**
-     * ID of the quiz
+     * Quiz ID, available from `step.quizOptions.id` on a quiz-type Online Programs step.
      * @format GUID
      */
     quizId: string;
 }
 interface GetQuizResponse {
-    /** Requested quiz */
+    /** Requested quiz definition. */
     quiz?: Quiz;
 }
 interface DeleteQuizRequest {
     /**
-     * ID of quiz
+     * ID of the quiz definition to permanently delete.
      * @format GUID
      */
     quizId: string;
 }
 interface DeleteQuizResponse {
-    /** Deleted quiz */
+    /** Permanently deleted quiz definition. */
     quiz?: Quiz;
 }
 interface BulkDeleteQuizzesRequest {
     /**
-     * IDs of the quizzes to delete.
+     * IDs of the quiz definitions to permanently delete. Coordinate deletion with the Steps API and remove known step references first.
      * @minSize 1
      * @maxSize 100
      * @format GUID
@@ -336,7 +360,7 @@ interface BulkDeleteQuizzesResponse {
     bulkActionMetadata?: BulkActionMetadata;
 }
 interface BulkDeleteQuizzesResponseBulkQuizResult {
-    /** Metadata for the individual delete operation. */
+    /** Metadata for the individual delete operation. When the operation fails, `error` contains the original Wix Forms application error. */
     itemMetadata?: ItemMetadata;
 }
 interface DomainEvent extends DomainEventBodyOneOf {
@@ -492,9 +516,57 @@ interface AccountInfo {
      */
     siteId?: string | null;
 }
+/** @docsIgnore */
+type CreateQuizApplicationErrors = {
+    code?: 'INVALID_QUIZ';
+    description?: string;
+    data?: Record<string, any>;
+} | {
+    code?: 'QUIZ_CONFLICT';
+    description?: string;
+    data?: Record<string, any>;
+};
+/** @docsIgnore */
+type CloneQuizApplicationErrors = {
+    code?: 'INVALID_QUIZ';
+    description?: string;
+    data?: Record<string, any>;
+} | {
+    code?: 'QUIZ_NOT_FOUND';
+    description?: string;
+    data?: Record<string, any>;
+} | {
+    code?: 'QUIZ_CONFLICT';
+    description?: string;
+    data?: Record<string, any>;
+};
+/** @docsIgnore */
+type BulkCreateQuizzesApplicationErrors = {
+    code?: 'INVALID_QUIZ';
+    description?: string;
+    data?: Record<string, any>;
+};
+/** @docsIgnore */
+type GetQuizApplicationErrors = {
+    code?: 'QUIZ_NOT_FOUND';
+    description?: string;
+    data?: Record<string, any>;
+};
+/** @docsIgnore */
+type DeleteQuizApplicationErrors = {
+    code?: 'QUIZ_NOT_FOUND';
+    description?: string;
+    data?: Record<string, any>;
+} | {
+    code?: 'QUIZ_CONFLICT';
+    description?: string;
+    data?: Record<string, any>;
+};
 /**
- * Creates quiz
- * @param quiz - Quiz to created
+ * Creates a detached quiz definition with at least one question.
+ *
+ * To use the quiz in an Online Program, pass the returned quiz ID as `step.quizOptions.id` when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
+ * @param quiz - Quiz definition to create. Generate a stable unique GUID for every `quiz.fields.id` value.
  * @public
  * @requiredField quiz
  * @requiredField quiz.fields
@@ -506,22 +578,38 @@ interface AccountInfo {
  * @requiredField quiz.fields.target
  * @permissionId QUIZZES.CREATE_QUIZ
  * @applicableIdentity APP
- * @returns Created quiz
+ * @returns Created quiz definition. Assign its `id` to `step.quizOptions.id` to create an Online Programs quiz step.
  * @fqn wix.achievements.quizzes.v1.QuizService.CreateQuiz
  */
-declare function createQuiz(quiz: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2>>;
+declare function createQuiz(quiz: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2> & {
+    __applicationErrorsType?: CreateQuizApplicationErrors;
+}>;
 /**
- * Clones quiz
- * @param quizId - ID of the quiz to be cloned
+ * Clones a quiz definition and returns a new quiz ID.
+ *
+ * Checks the source before cloning. An existing definition found to have no active questions is rejected with INVALID_QUIZ before cloning. Source checks aren't atomic with cloning.
+ *
+ * This operation copies the question and settings definition only. It doesn't copy Online Programs step associations or quiz submissions. Attach the returned ID to a step separately when needed.
+ * @param quizId - ID of the quiz definition to clone.
  * @public
  * @requiredField quizId
  * @permissionId QUIZZES.CREATE_QUIZ
  * @applicableIdentity APP
  * @fqn wix.achievements.quizzes.v1.QuizService.CloneQuiz
  */
-declare function cloneQuiz(quizId: string): Promise<NonNullablePaths<CloneQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3>>;
+declare function cloneQuiz(quizId: string): Promise<NonNullablePaths<CloneQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3> & {
+    __applicationErrorsType?: CloneQuizApplicationErrors;
+}>;
 /**
- * Creates up to 30 quiz definitions in a single API call.
+ * Creates up to 30 detached quiz definitions in a single API call. Each definition must contain at least one question.
+ *
+ * Quiz IDs, revisions, and creation and update timestamps are assigned by the server. Client-supplied values for these read-only fields are ignored. Question IDs (`quizzes.fields.id`) must be supplied by the caller.
+ *
+ * Invalid quiz definitions fail the entire request before any quizzes are created.
+ *
+ * Individual item failures don't fail the bulk request. For each failed item, `results.itemMetadata.error` contains the original application error from the Wix Forms operation.
+ *
+ * To use the quizzes in an Online Program, pass the returned quiz IDs as `step.quizOptions.id` values when calling the Steps API's `CreateStep` or `BulkCreateSteps` method.
  * @param quizzes - Quiz definitions to create.
  * @public
  * @documentationMaturity preview
@@ -537,7 +625,9 @@ declare function cloneQuiz(quizId: string): Promise<NonNullablePaths<CloneQuizRe
  * @applicableIdentity APP
  * @fqn wix.achievements.quizzes.v1.QuizService.BulkCreateQuizzes
  */
-declare function bulkCreateQuizzes(quizzes: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>[], options?: BulkCreateQuizzesOptions): Promise<NonNullablePaths<BulkCreateQuizzesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4>>;
+declare function bulkCreateQuizzes(quizzes: NonNullablePaths<Quiz, `fields` | `fields.${number}._id` | `fields.${number}.multiChoice.options` | `fields.${number}.question` | `fields.${number}.singleChoice.options` | `fields.${number}.target`, 3>[], options?: BulkCreateQuizzesOptions): Promise<NonNullablePaths<BulkCreateQuizzesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4> & {
+    __applicationErrorsType?: BulkCreateQuizzesApplicationErrors;
+}>;
 interface BulkCreateQuizzesOptions {
     /**
      * Whether to return the created quizzes in the response.
@@ -547,31 +637,45 @@ interface BulkCreateQuizzesOptions {
     returnEntity?: boolean;
 }
 /**
- * Reads quiz by ID
- * @param quizId - ID of the quiz
+ * Retrieves a quiz definition by ID. A stored definition whose questions have all been deleted can be returned with no active questions.
+ *
+ * To discover a quiz ID, query or retrieve its quiz-type Online Programs step and read `step.quizOptions.id`.
+ * @param quizId - Quiz ID, available from `step.quizOptions.id` on a quiz-type Online Programs step.
  * @public
  * @requiredField quizId
  * @permissionId achievements:quizzes:v1:quiz:get_quiz
  * @applicableIdentity APP
- * @returns Requested quiz
+ * @returns Requested quiz definition.
  * @fqn wix.achievements.quizzes.v1.QuizService.GetQuiz
  */
-declare function getQuiz(quizId: string): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2>>;
+declare function getQuiz(quizId: string): Promise<NonNullablePaths<Quiz, `fields` | `fields.${number}._id`, 2> & {
+    __applicationErrorsType?: GetQuizApplicationErrors;
+}>;
 /**
- * Deletes quiz
- * @param quizId - ID of quiz
+ * Permanently deletes a quiz definition.
+ *
+ * This operation doesn't check whether Online Programs steps reference the quiz. Coordinate deletion with the Steps API and remove known step references first. Otherwise, steps can retain dangling quiz references.
+ *
+ * NOT-PRECEDENT: This caller-responsibility behavior is retained as a production v1 compatibility exception. New delete APIs should provide an authoritative server-side reference safeguard.
+ * @param quizId - ID of the quiz definition to permanently delete.
  * @public
  * @requiredField quizId
  * @permissionId QUIZZES.DELETE_QUIZ
  * @applicableIdentity APP
  * @fqn wix.achievements.quizzes.v1.QuizService.DeleteQuiz
  */
-declare function deleteQuiz(quizId: string): Promise<NonNullablePaths<DeleteQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3>>;
+declare function deleteQuiz(quizId: string): Promise<NonNullablePaths<DeleteQuizResponse, `quiz.fields` | `quiz.fields.${number}._id`, 3> & {
+    __applicationErrorsType?: DeleteQuizApplicationErrors;
+}>;
 /**
  * Permanently deletes up to 100 quiz definitions.
  *
- * This operation doesn't check whether Online Programs steps reference the quizzes. Callers must remove or verify those references before deleting.
- * @param quizIds - IDs of the quizzes to delete.
+ * Individual item failures don't fail the bulk request. For each failed item, `results.itemMetadata.error` contains the original application error from the Wix Forms operation.
+ *
+ * This operation doesn't check whether Online Programs steps reference the quizzes. Coordinate deletion with the Steps API and remove known step references first. Otherwise, steps can retain dangling quiz references.
+ *
+ * NOT-PRECEDENT: This caller-responsibility behavior is retained as a production v1 compatibility exception. New bulk-delete APIs should provide an authoritative server-side reference safeguard.
+ * @param quizIds - IDs of the quiz definitions to permanently delete. Coordinate deletion with the Steps API and remove known step references first.
  * @public
  * @documentationMaturity preview
  * @requiredField quizIds
@@ -581,4 +685,4 @@ declare function deleteQuiz(quizId: string): Promise<NonNullablePaths<DeleteQuiz
  */
 declare function bulkDeleteQuizzes(quizIds: string[]): Promise<NonNullablePaths<BulkDeleteQuizzesResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 4>>;
 
-export { type AccountInfo, type ActionEvent, type ApplicationError, type BulkActionMetadata, type BulkCloneQuizzesRequest, type BulkCloneQuizzesResponse, type BulkCreateQuizzesOptions, type BulkCreateQuizzesRequest, type BulkCreateQuizzesResponse, type BulkCreateQuizzesResponseBulkQuizResult, type BulkDeleteQuizzesRequest, type BulkDeleteQuizzesResponse, type BulkDeleteQuizzesResponseBulkQuizResult, type BulkQuizResult, type CloneQuizRequest, type CloneQuizResponse, type CreateQuizRequest, type CreateQuizResponse, type DeleteQuizRequest, type DeleteQuizResponse, type DomainEvent, type DomainEventBodyOneOf, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type FileUploadField, FileUploadFormat, type FileUploadFormatWithLiterals, type GetQuizRequest, type GetQuizResponse, type IdentificationData, type IdentificationDataIdOneOf, type ItemMetadata, type LongTextField, type MessageEnvelope, type MultiChoiceField, type NumericField, type Quiz, type QuizField, type QuizFieldFieldTypeOneOf, type QuizSettings, type RestoreInfo, type ShortTextField, type SingleChoiceField, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkCreateQuizzes, bulkDeleteQuizzes, cloneQuiz, createQuiz, deleteQuiz, getQuiz };
+export { type AccountInfo, type ActionEvent, type ApplicationError, type BulkActionMetadata, type BulkCloneQuizzesRequest, type BulkCloneQuizzesResponse, type BulkCreateQuizzesApplicationErrors, type BulkCreateQuizzesOptions, type BulkCreateQuizzesRequest, type BulkCreateQuizzesResponse, type BulkCreateQuizzesResponseBulkQuizResult, type BulkDeleteQuizzesRequest, type BulkDeleteQuizzesResponse, type BulkDeleteQuizzesResponseBulkQuizResult, type BulkQuizResult, type CloneQuizApplicationErrors, type CloneQuizRequest, type CloneQuizResponse, type CreateQuizApplicationErrors, type CreateQuizRequest, type CreateQuizResponse, type DeleteQuizApplicationErrors, type DeleteQuizRequest, type DeleteQuizResponse, type DomainEvent, type DomainEventBodyOneOf, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type FileUploadField, FileUploadFormat, type FileUploadFormatWithLiterals, type GetQuizApplicationErrors, type GetQuizRequest, type GetQuizResponse, type IdentificationData, type IdentificationDataIdOneOf, type ItemMetadata, type LongTextField, type MessageEnvelope, type MultiChoiceField, type NumericField, type Quiz, type QuizField, type QuizFieldFieldTypeOneOf, type QuizSettings, type RestoreInfo, type ShortTextField, type SingleChoiceField, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkCreateQuizzes, bulkDeleteQuizzes, cloneQuiz, createQuiz, deleteQuiz, getQuiz };