@wix/auto_sdk_automations_trigger-provider 1.0.8 → 1.0.10

package/build/internal/cjs/src/service-plugins-types.d.ts

@@ -91,9 +91,9 @@ export interface OnAutomationSavedRequest {
     automation: Automation;
 }
 export interface Automation extends AutomationOriginInfoOneOf {
-    /** Application info */
+    /** When the origin of the automation is `APPLICATION`, the details of the app that created it. */
     applicationInfo?: ApplicationOrigin;
-    /** Preinstalled info */
+    /** When the origin of the automation is `PREINSTALLED`, the details of the preinstalled automation. */
     preinstalledInfo?: PreinstalledOrigin;
     /**
      * Automation ID.
@@ -102,37 +102,33 @@ export interface Automation extends AutomationOriginInfoOneOf {
      */
     _id?: string | null;
     /**
-     * Revision number, which increments by 1 each time the automation is updated.
-     * To prevent conflicting changes,
-     * the current revision must be passed when updating the automation.
-     *
-     * Ignored when creating an automation.
+     * Revision number. This increments by 1 whenever the automation is updated. Specify the current revision number whenever updating an existing automation.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Information about the creator of the automation.
+     * Who created the automation.
      * @immutable
      * @readonly
      */
     createdBy?: AuditInfo;
     /**
-     * Date and time the automation was created.
+     * When the automation was created.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * The entity that last updated the automation.
+     * Who last updated the automation.
      * @readonly
      */
     updatedBy?: AuditInfo;
     /**
-     * Date and time the automation was last updated.
+     * When the automation was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
     /**
-     * Automation name that is displayed on the user's site.
+     * Automation name as displayed on the user's site.
      * @minLength 1
      * @maxLength 500
      */
@@ -142,60 +138,71 @@ export interface Automation extends AutomationOriginInfoOneOf {
      * @maxLength 2000
      */
     description?: string | null;
-    /** Object that defines the automation's trigger, actions, and activation status. */
+    /** Automation configuration. */
     configuration?: AutomationConfiguration;
     /**
-     * Defines how the automation was added to the site.
+     * How the automation was added to the user's site.
      * @immutable
      */
     origin?: Origin;
     /** Automation settings. */
     settings?: AutomationSettings;
     /**
-     * Draft info (optional - only if the automation is a draft)
+     * When the automation is a draft, the draft details.
      * @readonly
      */
     draftInfo?: DraftInfo;
     /**
-     * Namespace
-     * @maxLength 50
+     * Whether the automation is archived.
+     *
+     * To archive an automation, set this to `true`. To restore an archived automation, set this to `false`.
      */
-    namespace?: string | null;
-    /** Extended Fields */
-    extendedFields?: ExtendedFields;
+    archived?: boolean;
 }
 /** @oneof */
 export interface AutomationOriginInfoOneOf {
-    /** Application info */
+    /** When the origin of the automation is `APPLICATION`, the details of the app that created it. */
     applicationInfo?: ApplicationOrigin;
-    /** Preinstalled info */
+    /** When the origin of the automation is `PREINSTALLED`, the details of the preinstalled automation. */
     preinstalledInfo?: PreinstalledOrigin;
 }
 export interface ActionSettings {
     /**
-     * List of actions that cannot be deleted.
-     * Default: Empty. All actions are deletable by default.
+     * Permanent actions. Permanent actions cannot be deleted.
+     *
+     * When empty, all actions can be deleted by the user.
      * @maxSize 30
      * @format GUID
      */
     permanentActionIds?: string[];
     /**
-     * List of actions that cannot be edited.
-     * Default: Empty. All actions are editable by default.
+     * Read-only actions. Read-only actions cannot be edited.
+     *
+     * When empty, all actions are editable.
      * @maxSize 30
      * @format GUID
      */
     readonlyActionIds?: string[];
-    /** Whether the option to add a delay is disabled for the automation. */
+    /**
+     * Whether to disable the ability to add a delay to the automation.
+     *
+     * Default: `false`.
+     */
     disableDelayAddition?: boolean;
-    /** Whether the option to add a condition is disabled for the automation. */
+    /**
+     * Whether to disable the ability to add a condition to the automation.
+     *
+     * Default: `false`.
+     */
     disableConditionAddition?: boolean;
 }
 export declare enum Domain {
     /** User domain (default). */
     USER = "USER",
     /** Wix domain. */
-    WIX = "WIX"
+    WIX = "WIX",
+    /** Wix account-level domain. */
+    WIX_ACCOUNT = "WIX_ACCOUNT"
 }
 export interface Enrichment {
     /**
@@ -206,12 +213,14 @@ export interface Enrichment {
 }
 export interface AuditInfo extends AuditInfoIdOneOf {
     /**
-     * User ID.
+     * [User ID](https://dev.wix.com/docs/build-apps/get-started/overview/glossary#user-id).
      * @format GUID
      */
     userId?: string;
     /**
-     * Application ID.
+     * [App ID](https://dev.wix.com/docs/build-apps/get-started/overview/glossary#app-id).
+     *
+     * You can find the app ID on the [Home page](https://manage.wix.com/app-selector?title=Select+an+App&primaryButtonText=Select+Site&actionUrl=https%3A%2F%2Fdev.wix.com%2Fapps%2F%7BappId%7D%home) in the app's dashboard.
      * @format GUID
      */
     appId?: string;
@@ -219,40 +228,45 @@ export interface AuditInfo extends AuditInfoIdOneOf {
 /** @oneof */
 export interface AuditInfoIdOneOf {
     /**
-     * User ID.
+     * [User ID](https://dev.wix.com/docs/build-apps/get-started/overview/glossary#user-id).
      * @format GUID
      */
     userId?: string;
     /**
-     * Application ID.
+     * [App ID](https://dev.wix.com/docs/build-apps/get-started/overview/glossary#app-id).
+     *
+     * You can find the app ID on the [Home page](https://manage.wix.com/app-selector?title=Select+an+App&primaryButtonText=Select+Site&actionUrl=https%3A%2F%2Fdev.wix.com%2Fapps%2F%7BappId%7D%home) in the app's dashboard.
      * @format GUID
      */
     appId?: string;
 }
-/** Automation runtime configuration */
 export interface AutomationConfiguration {
     /** Status of the automation on the site. */
     status?: Status;
-    /** Automation trigger configuration. */
+    /** Trigger configuration. */
     trigger?: Trigger;
     /**
-     * List of IDs of root actions. Root actions are the first actions to run after the trigger. The actions in the list run in parallel.
+     * Root action IDs. A root action is the first action that runs after the trigger occurs. Root actions run in parallel.
+     *
+     * > **Note**: You can currently only specify 1 root action.
      * @maxSize 20
      * @format GUID
      */
     rootActionIds?: string[];
-    /**
-     * Map of all actions that the automation may execute.
-     * The key is the action ID, and the value is the action configuration.
-     */
+    /** Actions the automation can execute, as key:value pairs. For the key, specify the action ID. The value must be an object structured as described below. */
     actions?: Record<string, Action>;
 }
 export declare enum TimeUnit {
     UNKNOWN_TIME_UNIT = "UNKNOWN_TIME_UNIT",
+    /** Minutes. */
     MINUTES = "MINUTES",
+    /** Hours. */
     HOURS = "HOURS",
+    /** Days. */
     DAYS = "DAYS",
+    /** Weeks. */
     WEEKS = "WEEKS",
+    /** Months. */
     MONTHS = "MONTHS"
 }
 export interface Filter {
@@ -262,42 +276,49 @@ export interface Filter {
      */
     _id?: string;
     /**
-     * Field key from the payload schema, for example "formId".
+     * Field key.
+     *
+     * You can find the field key in [the trigger payload schema](https://dev.wix.com/docs/rest/business-management/automations/triggers/the-trigger-payload-schema).
      * @minLength 1
      * @maxLength 110
      */
     fieldKey?: string;
     /**
-     * Filter expression that evaluates to a boolean.
+     * Filter expression.
+     *
+     * For the automation to run, the expression must evaluate to `true`.
      * @maxLength 2500
      */
     filterExpression?: string;
 }
 export interface FutureDateActivationOffset {
     /**
-     * The offset value. The value is always taken as negative, so that the automation runs before the trigger date.
-     * To create an offset that causes the automation to run after the trigger date, use a delay action.
+     * Amount of time before the trigger to run the automation.
+     *
+     * > **Note**: To delay an automation after the trigger event occurs, use a [delay action](https://dev.wix.com/docs/rest/business-management/automations/automations/automations-v2/about-automation-configuration#delay-action).
      * @maxLength 1000
      */
     preScheduledEventOffsetExpression?: string;
-    /** Time unit for the scheduled event offset. */
+    /** Unit in which to set the action offset. */
     scheduledEventOffsetTimeUnit?: TimeUnit;
 }
 export interface RateLimit {
     /**
-     * Value expressing the maximum number of times the trigger can be activated.
+     * Maximum number of times the trigger can be activated.
      * @maxLength 1000
      */
     maxActivationsExpression?: string;
     /**
-     * Duration of the rate limiting window in the selected time unit. If no value is set, the rate limit is permanent.
+     * Duration of the rate limit. The rate limit applies for the specified duration and then expires.
+     *
+     * When empty, the rate limit does not expire.
      * @maxLength 1000
      */
     durationExpression?: string | null;
-    /** Time unit for the rate limit duration. */
+    /** Unit in which to set the duration of the rate limit. */
     durationTimeUnit?: TimeUnit;
     /**
-     * Unique identifier of each activation, by which rate limiter will count activations.
+     * Activation identifier used to count the number of activations.
      * @minLength 1
      * @maxLength 400
      */
@@ -305,17 +326,17 @@ export interface RateLimit {
 }
 export interface FilterValueSelection {
     /**
-     * Values that can help the user filter certain automations, values will look like "<filter_id>__<selected_value>"
+     * Values that can help the user filter certain automations. Specify values in the following format: `<filter_id>__<selected_value>`.
      * @maxLength 80
      * @maxSize 50
      */
     selectedFilterValues?: string[];
 }
 export interface ConditionExpressionGroup {
-    /** Expression group operator. */
+    /** Logical operator used to evaluate the condition expressions. */
     operator?: Operator;
     /**
-     * List of boolean expressions to be evaluated with the given operator.
+     * Expressions evaluated using the selected operator.
      * @minSize 1
      * @maxSize 20
      * @maxLength 2500
@@ -323,25 +344,58 @@ export interface ConditionExpressionGroup {
     booleanExpressions?: string[];
 }
 export declare enum Operator {
+    /** Unknown. */
     UNKNOWN_OPERATOR = "UNKNOWN_OPERATOR",
+    /** `OR` operator. */
     OR = "OR",
+    /** `AND` operator. */
     AND = "AND"
 }
+export interface CodeSnippet {
+    /** Logical operator used to evaluate the condition expressions. */
+    language?: Language;
+    /**
+     * Expressions evaluated using the selected operator. this code should comply the language syntax. and format
+     * @maxLength 1000
+     */
+    code?: string;
+}
+export declare enum Language {
+    /** Unknown. */
+    UNKNOWN_LANGUAGE = "UNKNOWN_LANGUAGE",
+    /** `JAVASCRIPT` language. */
+    JAVASCRIPT = "JAVASCRIPT"
+}
+/** Path definition */
+export interface Path {
+    /**
+     * Unique path ID.
+     * @format GUID
+     */
+    _id?: string;
+    /**
+     * Path display name.
+     * @minLength 1
+     * @maxLength 100
+     */
+    name?: string;
+    /**
+     * ID of the action to run when this path is taken.
+     * @format GUID
+     */
+    postActionId?: string | null;
+}
 export declare enum Type {
-    /** Automation will be triggered according to the trigger configuration. */
+    /** Based on the trigger. */
     UNKNOWN_ACTION_TYPE = "UNKNOWN_ACTION_TYPE",
-    /** App defined Action. */
+    /** Defined by a [Wix app](https://dev.wix.com/docs/rest/business-management/automations/automations/automations-v2/about-automation-configuration#app-defined-actions). This action type is available in the site dashboard. */
     APP_DEFINED = "APP_DEFINED",
-    /** Condition Action. */
+    /** Condition. This determines which action runs next. */
     CONDITION = "CONDITION",
-    /** Delay Action. */
+    /** Delay. The automation must wait before executing the next step. */
     DELAY = "DELAY",
-    /** RateLimit Action. */
-    RATE_LIMIT = "RATE_LIMIT",
-    /** Set Variables Action. */
-    SET_VARIABLES = "SET_VARIABLES",
-    /** Output Action. */
-    OUTPUT = "OUTPUT"
+    /** Rate-limiter. This stops the automation flow if the subsequent action has reached its maximum allowed executions. */
+    RATE_LIMIT = "RATE_LIMIT"
 }
 export interface AppDefinedAction {
     /**
@@ -355,39 +409,55 @@ export interface AppDefinedAction {
      * @maxLength 100
      */
     actionKey?: string;
-    /** Action input mapping. */
+    /** Action input mapping as defined in the action's [input schema](https://dev.wix.com/docs/rest/business-management/automations/actions/the-action-input-schema). */
     inputMapping?: Record<string, any> | null;
     /**
-     * Array of conditions determining whether to skip the action in the automation flow.
-     * The action will be skipped if any of the expression groups evaluate to `true`.
-     * Actions following a skipped action will still run.
+     * Action skip conditions. An action is skipped if any of the specified conditions evaluates to `true`.
+     *
+     * > **Note**: Actions that follow a skipped action still run.
      * @maxSize 10
      */
     skipConditionOrExpressionGroups?: ConditionExpressionGroup[];
     /**
-     * List of IDs of actions to run in parallel once the action completes.
+     * IDs of actions that run in parallel after the action completes.
      * @maxSize 20
      * @format GUID
      */
     postActionIds?: string[];
-    /** Optional output schema of the action. It will be used instead the action schema in case it's provided. */
+    /** Action output schema. When specified, this replaces the action schema. */
     overrideOutputSchema?: Record<string, any> | null;
 }
 export interface ConditionAction {
     /**
-     * The condition evaluates to `true` if either of the expression groups evaluate to `true`.
+     * Condition is `true` if one or more of the expression groups evaluates to `true`.
      * @minSize 1
      * @maxSize 10
      */
     orExpressionGroups?: ConditionExpressionGroup[];
     /**
-     * List of IDs of actions to run when the entire condition is evaluated to `true`.
+     * IDs of actions to run when the condition evaluates to `true`.
      * @maxSize 20
      * @format GUID
      */
     truePostActionIds?: string[];
     /**
-     * List of IDs of actions to run when the entire condition is evaluated to `false`.
+     * IDs of actions to run when the condition evaluates to `false`.
+     * @maxSize 20
+     * @format GUID
+     */
+    falsePostActionIds?: string[];
+}
+export interface CodeConditionAction {
+    /** condition code. This is a code that can be used to identify the condition in the automation. code should return a boolean value. otherwise the value will be tried to be casted to boolean. */
+    snippet?: CodeSnippet;
+    /**
+     * IDs of actions to run when the condition evaluates to `true`.
+     * @maxSize 20
+     * @format GUID
+     */
+    truePostActionIds?: string[];
+    /**
+     * IDs of actions to run when the condition evaluates to `false`.
      * @maxSize 20
      * @format GUID
      */
@@ -395,21 +465,23 @@ export interface ConditionAction {
 }
 export interface DelayAction {
     /**
-     * Value expressing the amount of time to wait from a specific date or from the time the action is executed.
+     * Time to wait before running the action. The wait time starts from when the current action completes.
+     *
+     * > **Note**: To define the wait time from a specific moment in time, use `dueDateEpochExpression`.
      * @maxLength 1000
      */
     offsetExpression?: string | null;
-    /** Time unit for delay offset. */
+    /** Unit in which to set the wait time to wait before the action runs. */
     offsetTimeUnit?: TimeUnit;
     /**
-     * The action due date. If defined without an offset, the automation will wait until this date to execute the next step.
-     * If an offset is defined, it's calculated from this date.
-     * The date is expressed in the number of milliseconds since the Unix Epoch (1 January, 1970 UTC).
+     * Action run date in milliseconds elapsed since January 1, 1970 UTC.
+     *
+     * > **Note**: If an `offsetExpression` is defined, the delay is calculated from the time of the offset.
      * @maxLength 1000
      */
     dueDateEpochExpression?: string | null;
     /**
-     * List of IDs of actions to run in parallel after the delay.
+     * IDs of actions to run in parallel after the time delay.
      * @maxSize 20
      * @format GUID
      */
@@ -417,17 +489,18 @@ export interface DelayAction {
 }
 export interface RateLimitAction {
     /**
-     * The maximum number of activations allowed for the action.
+     * Maximum number of times the action can run.
      * @maxLength 1000
      */
     maxActivationsExpression?: string;
     /**
-     * Duration of the rate limiting window, expressed in selected time unit.
-     * If no value is set, then there is no time limit on the rate limiter.
+     * Rate limit duration.
+     *
+     * When empty, the rate limit does not expire.
      * @maxLength 1000
      */
     rateLimitDurationExpression?: string | null;
-    /** Time unit for the rate limit duration. */
+    /** Unit in which to set the duration of the rate limit. */
     rateLimitDurationTimeUnit?: TimeUnit;
     /**
      * Unique identifier of each activation by which rate limiter counts activations.
@@ -436,25 +509,23 @@ export interface RateLimitAction {
      */
     uniqueIdentifierExpression?: string | null;
     /**
-     * List of IDs of actions to run in parallel once the action completes.
+     * IDs of actions to run in parallel after the action completes.
      * @maxSize 20
      * @format GUID
      */
     postActionIds?: string[];
 }
 export interface SetVariablesAction {
-    /**
-     * output mapping
-     * for example: {"someField": "{{10}}", "someOtherField": "{{multiply( var('account.points.balance') ;2 )}}" }
-     */
+    /** Output mapping. For example: `{"someField": "{{10}}", "someOtherField": "{{multiply( var('account.points.balance') ;2 )}}" }`. */
     outputMapping?: Record<string, any> | null;
     /**
-     * output json schema representation
-     * could be string instead of Struct (and introduce some compression to minimize the size of it)
+     * Output JSON schema representation.
+     *
+     * > **Note**: To minimize request size, you can also specify a string.
      */
     outputSchema?: Record<string, any> | null;
     /**
-     * List of IDs of actions to run in parallel after variable initialization.
+     * IDs of actions to run in parallel after variable initialization.
      * @maxSize 20
      * @format GUID
      */
@@ -464,12 +535,20 @@ export interface OutputAction {
     /** Output action output mapping. */
     outputMapping?: Record<string, any> | null;
 }
+export interface SplitAction {
+    /**
+     * List of paths to split execution into.
+     * @minSize 2
+     * @maxSize 10
+     */
+    paths?: Path[];
+}
 export declare enum Status {
-    /** unused */
+    /** Unknown. */
     UNKNOWN_STATUS = "UNKNOWN_STATUS",
-    /** Automation will be triggered according to the trigger configuration */
+    /** Active. Active automations can be triggered. */
     ACTIVE = "ACTIVE",
-    /** Automation will not be triggered */
+    /** Inactive. Inactive automations cannot be triggered. */
     INACTIVE = "INACTIVE"
 }
 export interface Trigger {
@@ -480,51 +559,54 @@ export interface Trigger {
     appId?: string;
     /**
      * Trigger key.
+     *
+     * Learn about [setting up a trigger](https://dev.wix.com/docs/rest/business-management/automations/triggers/add-a-trigger-to-your-app#step-1--set-up-the-trigger).
      * @minLength 1
      * @maxLength 100
      */
     triggerKey?: string;
     /**
-     * List of filters on schema fields.
-     * In order for the automation to run, all filter expressions must evaluate to `true` for a given payload.
+     * Schema field filters. All filter conditions must be met for the automation to run.
+     *
+     * Learn more about setting up [automation filters](https://dev.wix.com/docs/rest/business-management/automations/automations/automations-v2/about-automation-configuration#filters).
      * @maxSize 5
      */
     filters?: Filter[];
-    /** Defines the time offset between the trigger date and when the automation runs. */
-    scheduledEventOffset?: FutureDateActivationOffset;
-    /** Limits the number of times an automation can be triggered. */
-    rateLimit?: RateLimit;
     /**
-     * An optional configuration, per automation, of a schema that is optionally offered by the trigger provider to affect the behavior of the trigger.
-     * For example, a trigger provider may offer a schema that allows the user to configure the trigger to happen at a certain time of day,
-     * He would define a schema with a field called "startDate" and using this parameter the user can define his preferred startDate, per automation.
+     * Automation offset. You can schedule automations to run before the trigger occurs.
+     *
+     * Learn more about [scheduled events](https://dev.wix.com/docs/rest/business-management/automations/automations/automations-v2/configure-your-automation#scheduled-events).
      */
-    automationConfigMapping?: Record<string, any> | null;
-    /** Optional schema of the trigger. It will be used instead the trigger schema in case it's provided. */
+    scheduledEventOffset?: FutureDateActivationOffset;
+    /** Limit on the number of times an automation can be triggered. */
+    rateLimit?: RateLimit;
+    /** Trigger schema override. When specified, this replaces the trigger schema. */
     overrideSchema?: Record<string, any> | null;
 }
 export interface Action extends ActionInfoOneOf {
-    /** Action defined by an app (via RPC, HTTP or Velo). */
+    /** Details of the action when its `type` is `APP_DEFINED`. */
     appDefinedInfo?: AppDefinedAction;
-    /** Condition action. */
+    /** Details of the action when its `type` is `CONDITION`. */
     conditionInfo?: ConditionAction;
-    /** Delay action. */
+    /** Details of the action when its `type` is `CODE_CONDITION`. */
+    codeConditionInfo?: CodeConditionAction;
+    /** Details of the action when its `type` is `DELAY`. */
     delayInfo?: DelayAction;
-    /** Rate-limiting action. */
+    /** Details of the action when its `type` is `RATE_LIMIT`. */
     rateLimitInfo?: RateLimitAction;
     /**
-     * Action ID. If not specified, a new ID is generated.
+     * Action ID.
+     *
+     * If not specified, automatically generated by Wix.
      * @format GUID
      */
     _id?: string | null;
-    /** Action type. */
+    /** [Action type](https://dev.wix.com/docs/rest/business-management/automations/automations/automations-v2/about-automation-configuration#action-type). */
     type?: Type;
     /**
-     * Human-readable name to differentiate the action from other actions of the same type.
-     * The name can contain only alphanumeric characters and underscores. If not provided, a namespace in the form `actionkey-indexOfAction` is
-     * generated automatically.
-     * If the action has output, the output will be available in the payload under this name.
-     * If the user has multiple actions with the same appId and actionKey, previous action output will be overwritten.
+     * [Action namespace](https://dev.wix.com/docs/rest/business-management/automations/automations/automations-v2/about-automation-configuration#namespace). This differentiates it from other actions of the same type.
+     *
+     * If the action outputs any data, the data appears under the namespace in the payload sent to the subsequent steps in the automation. If the user has multiple actions with the same `appId` and `actionKey`, the output of the previous action is overwritten.
      * @minLength 1
      * @maxLength 100
      */
@@ -532,18 +614,20 @@ export interface Action extends ActionInfoOneOf {
 }
 /** @oneof */
 export interface ActionInfoOneOf {
-    /** Action defined by an app (via RPC, HTTP or Velo). */
+    /** Details of the action when its `type` is `APP_DEFINED`. */
     appDefinedInfo?: AppDefinedAction;
-    /** Condition action. */
+    /** Details of the action when its `type` is `CONDITION`. */
     conditionInfo?: ConditionAction;
-    /** Delay action. */
+    /** Details of the action when its `type` is `CODE_CONDITION`. */
+    codeConditionInfo?: CodeConditionAction;
+    /** Details of the action when its `type` is `DELAY`. */
     delayInfo?: DelayAction;
-    /** Rate-limiting action. */
+    /** Details of the action when its `type` is `RATE_LIMIT`. */
     rateLimitInfo?: RateLimitAction;
 }
 export interface FilterableAppDefinedActions {
     /**
-     * App defined action identifiers, each identifier in form `${appId}_${actionKey}`
+     * App-defined action identifiers. Identifiers have the following format: `${appId}_${actionKey}`.
      * @minSize 1
      * @maxSize 100
      * @minLength 1
@@ -552,48 +636,40 @@ export interface FilterableAppDefinedActions {
     actionIdentifiers?: string[];
 }
 export declare enum Origin {
-    /** Default value. This is unused. */
+    /** Default value. */
     UNKNOWN_ORIGIN = "UNKNOWN_ORIGIN",
-    /** User created automation. */
+    /** Created by a [Wix user](https://dev.wix.com/docs/build-apps/get-started/overview/glossary#wix-user). */
     USER = "USER",
-    /** Automation created by application (site specific). */
+    /** Created by a [Wix app](https://dev.wix.com/docs/build-apps/get-started/overview/glossary#wix-app) for a particular site. */
     APPLICATION = "APPLICATION",
-    /** Preinstalled application automation. */
-    PREINSTALLED = "PREINSTALLED",
-    /** Automation created from a recipe. */
-    RECIPE = "RECIPE"
+    /** [Preinstalled automation](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/automations/pre-installed-automations/about-pre-installed-automations). */
+    PREINSTALLED = "PREINSTALLED"
 }
 export interface ApplicationOrigin {
     /**
-     * Application ID.
+     * [App ID](https://dev.wix.com/docs/build-apps/get-started/overview/glossary#app-id).
+     *
+     * You can find the app ID on the [Home page](https://manage.wix.com/app-selector?title=Select+an+App&primaryButtonText=Select+Site&actionUrl=https%3A%2F%2Fdev.wix.com%2Fapps%2F%7BappId%7D%home) in the app's dashboard.
      * @format GUID
      */
     appId?: string;
-    /**
-     * External ID to correlate multiple sites to an automation
-     * @format GUID
-     */
-    appDefinedExternalId?: string | null;
 }
 export interface PreinstalledOrigin {
     /**
-     * ID of the app that defines the preinstalled automation.
+     * ID of the app that added the [preinstalled automation](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/automations/pre-installed-automations/about-pre-installed-automations).
      * @format GUID
      */
     appId?: string;
     /**
-     * Application component ID.
-     * @format GUID
-     */
-    componentId?: string;
-    /** Application component version. */
-    componentVersion?: number;
-    /**
-     * Whether the automation is an override automation. If the user modifies the preinstalled automation installed on their site, a site-specific
-     * automation is created that overrides the original one. If the user makes no modifications this boolean is set to `false` and the original
-     * preinstalled automation is used.
+     * Whether the automation is an override.
      *
-     * Default: `false`
+     * When a user modifies the preinstalled automation installed on their site, a site-specific version of the automation is created that overrides the automation that was originally installed. This override automation has the same automation ID as the original preinstalled automation.
+     *
+     * > **Note**: An override automation can no longer be updated by the app that originally installed it.
+     * >
+     * > To revert to the original preinstalled version, the user must delete the override by calling the Delete Automation method. Calling Delete Automation on an override automation removes the override method and restores the preinstalled automation that was previously installed.
+     *
+     * Default: `false`.
      * @immutable
      * @readonly
      */
@@ -602,22 +678,26 @@ export interface PreinstalledOrigin {
 export interface AutomationSettings {
     /**
      * Whether the automation is hidden from users.
+     *
      * Default: `false`
      */
     hidden?: boolean;
     /**
      * Whether the automation is read-only.
+     *
      * Default: `false`
      */
     readonly?: boolean;
     /**
-     * Whether the option to delete the automation from the site is disabled.
-     * Default: `false`
+     * Whether to disable the option to delete the automation from the site.
+     *
+     * Default: `false`.
      */
     disableDelete?: boolean;
     /**
-     * Whether the option to change the automation status (from active to inactive and vice versa) is disabled.
-     * Default: `false`
+     * Whether to disable the option to change the automation's `configuration.status`, for example from `ACTIVE` to `INACTIVE`.
+     *
+     * Default: `false`.
      */
     disableStatusChange?: boolean;
     /** Automation action settings. */
@@ -625,7 +705,7 @@ export interface AutomationSettings {
 }
 export interface DraftInfo {
     /**
-     * Optional - automationId of the original automation.
+     * ID of the original automation.
      * @format GUID
      * @readonly
      */