@wix/automations 1.0.17 → 1.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2056,7 +2056,6 @@ declare namespace meta$1 {
2056
2056
  export { type __PublicMethodMetaInfo$1 as __PublicMethodMetaInfo, meta$1_bulkCancelEvent as bulkCancelEvent, meta$1_bulkReportEvent as bulkReportEvent, meta$1_cancelEvent as cancelEvent, meta$1_reportEvent as reportEvent };
2057
2057
  }
2058
2058
 
2059
- /** Automation */
2060
2059
  interface Automation$1 extends AutomationOriginInfoOneOf$1 {
2061
2060
  /** Application info */
2062
2061
  applicationInfo?: ApplicationOrigin$1;
@@ -2070,43 +2069,43 @@ interface Automation$1 extends AutomationOriginInfoOneOf$1 {
2070
2069
  */
2071
2070
  id?: string | null;
2072
2071
  /**
2073
- * Revision number, which increments by 1 each time the Automation is updated.
2072
+ * Revision number, which increments by 1 each time the automation is updated.
2074
2073
  * To prevent conflicting changes,
2075
- * the current revision must be passed when updating the Automation.
2074
+ * the current revision must be passed when updating the automation.
2076
2075
  *
2077
- * Ignored when creating an Automation.
2076
+ * Ignored when creating an automation.
2078
2077
  * @readonly
2079
2078
  */
2080
2079
  revision?: string | null;
2081
2080
  /**
2082
- * information about the creator of the automation
2081
+ * Information about the creator of the automation.
2083
2082
  * @readonly
2084
2083
  */
2085
2084
  createdBy?: AuditInfo$1;
2086
2085
  /**
2087
- * Date and time the Automation was created.
2086
+ * Date and time the automation was created.
2088
2087
  * @readonly
2089
2088
  */
2090
2089
  createdDate?: Date;
2091
2090
  /**
2092
- * information about who updated of the automation
2091
+ * The entity that last updated the automation.
2093
2092
  * @readonly
2094
2093
  */
2095
2094
  updatedBy?: AuditInfo$1;
2096
2095
  /**
2097
- * Date and time the Automation was last updated.
2096
+ * Date and time the automation was last updated.
2098
2097
  * @readonly
2099
2098
  */
2100
2099
  updatedDate?: Date;
2101
- /** Automation name */
2100
+ /** Automation name that is displayed on the user's site. */
2102
2101
  name?: string;
2103
- /** Automation description */
2102
+ /** Automation description. */
2104
2103
  description?: string | null;
2105
- /** Automation runtime configuration */
2104
+ /** Object that defines the automation's trigger, actions, and activation status. */
2106
2105
  configuration?: AutomationConfiguration$1;
2107
- /** Origin type */
2106
+ /** Defines how the automation was added to the site. */
2108
2107
  origin?: Origin$1;
2109
- /** Automation settings */
2108
+ /** Automation settings. */
2110
2109
  settings?: AutomationSettings$1;
2111
2110
  }
2112
2111
  /** @oneof */
@@ -2119,39 +2118,45 @@ interface AutomationOriginInfoOneOf$1 {
2119
2118
  draftInfo?: DraftOrigin$1;
2120
2119
  }
2121
2120
  interface ActionSettings$1 {
2122
- /** list of permanent action ids of actions that cannot be deleted (default - empty, all actions are deletable by default) */
2121
+ /**
2122
+ * List of actions that cannot be deleted.
2123
+ * Default: Empty. All actions are deletable by default.
2124
+ */
2123
2125
  permanentActionIds?: string[];
2124
- /** list of readonly action ids, (default - empty, all actions are editable by default) */
2126
+ /**
2127
+ * List of actions that cannot be edited.
2128
+ * Default: Empty. All actions are editable by default.
2129
+ */
2125
2130
  readonlyActionIds?: string[];
2126
- /** sets if adding a delay action is disabled for this automation */
2131
+ /** Whether the option to add a delay is disabled for the automation. */
2127
2132
  disableDelayAddition?: boolean;
2128
- /** sets if adding a condition action is disabled for this automation */
2133
+ /** Whether the option to add a condition is disabled for the automation. */
2129
2134
  disableConditionAddition?: boolean;
2130
2135
  }
2131
2136
  interface AuditInfo$1 extends AuditInfoIdOneOf$1 {
2132
- /** user identifier */
2137
+ /** User ID. */
2133
2138
  userId?: string;
2134
- /** application identifier */
2139
+ /** Application ID. */
2135
2140
  appId?: string;
2136
2141
  }
2137
2142
  /** @oneof */
2138
2143
  interface AuditInfoIdOneOf$1 {
2139
- /** user identifier */
2144
+ /** User ID. */
2140
2145
  userId?: string;
2141
- /** application identifier */
2146
+ /** Application ID. */
2142
2147
  appId?: string;
2143
2148
  }
2144
2149
  /** Automation runtime configuration */
2145
2150
  interface AutomationConfiguration$1 {
2146
- /** Automation's Status */
2151
+ /** Status of the automation on the site. */
2147
2152
  status?: Status$1;
2148
- /** Trigger configuration */
2153
+ /** Automation trigger configuration. */
2149
2154
  trigger?: Trigger$1;
2150
- /** actions that run in parallel after the trigger */
2155
+ /** 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. */
2151
2156
  rootActionIds?: string[];
2152
2157
  /**
2153
- * map of all actions by actionId
2154
- * The key is the actionId of the action, and the value is the action configuration
2158
+ * Map of all actions that the automation may execute.
2159
+ * The key is the action ID, and the value is the action configuration.
2155
2160
  */
2156
2161
  actions?: Record<string, Action$1>;
2157
2162
  }
@@ -2164,51 +2169,36 @@ declare enum TimeUnit$1 {
2164
2169
  MONTHS = "MONTHS"
2165
2170
  }
2166
2171
  interface Filter$1 {
2167
- /** the filter identifier */
2172
+ /** Filter ID. */
2168
2173
  id?: string;
2169
- /** the field key from the schema, for example "formId" */
2174
+ /** Field key from the payload schema, for example "formId". */
2170
2175
  fieldKey?: string;
2171
- /** filter expression that evaluates to a boolean, for example - {{ contains(["guid1","guid2"];formId) }} */
2176
+ /** Filter expression that evaluates to a boolean. */
2172
2177
  filterExpression?: string;
2173
2178
  }
2174
2179
  interface FutureDateActivationOffset$1 {
2175
2180
  /**
2176
- * expression of offset before the trigger's time (in selected time unit), when the Automation should run
2177
- * only allows negative offset from the trigger's date (before the trigger), positive offset should be achieved via offset delay action
2178
- * preScheduledEventOffsetExpression: "{{5}}" + timeUnit: Days - to run the Automation 5 days before the trigger's date
2179
- * or, preScheduledEventOffsetExpression: "{{ someNumberField }}" + timeUnit: Minutes, to run the Automation someNumberField's value in minutes before the trigger's date
2181
+ * The offset value. The value is always taken as negative, so that the automation runs before the trigger date.
2182
+ * To create an offset that causes the automation to run after the trigger date, use a delay action.
2180
2183
  */
2181
2184
  preScheduledEventOffsetExpression?: string;
2182
- /** Time unit for the scheduled event offset */
2185
+ /** Time unit for the scheduled event offset. */
2183
2186
  scheduledEventOffsetTimeUnit?: TimeUnit$1;
2184
2187
  }
2185
2188
  interface RateLimit$1 {
2186
- /**
2187
- * Maximum number of activations expression. the expression will need to be parsed to Int on runtime
2188
- * for example - "{{ 1 }}" to set max activations to 1, or "{{ var(someNumberField) }}" to set max activations as the value of "someNumberField" from the payload
2189
- */
2189
+ /** Value expressing the maximum number of times the trigger can be activated. */
2190
2190
  maxActivationsExpression?: string;
2191
- /**
2192
- * Duration of the rate limiting window (in selected time unit) expression for rate limiter, if empty then no time limit. the expression will need to be parsed to Int on runtime
2193
- * for example - "{{ 10 }}" to set timeframe to be 10 minutes, or {{ var(someNumberField) }} to set timeframe in minutes as the value of "someNumberField" from the payload
2194
- */
2191
+ /** Duration of the rate limiting window in the selected time unit. If no value is set, the rate limit is permanent. */
2195
2192
  durationExpression?: string | null;
2196
- /** Time unit for the rate limit duration */
2193
+ /** Time unit for the rate limit duration. */
2197
2194
  durationTimeUnit?: TimeUnit$1;
2198
- /**
2199
- * Unique identifier of each activation by which rate limiter will count activations, expected return type is string
2200
- * for example - {{ var(contact.id) }} to set the unique identifier as the value of "contact.id" from the payload
2201
- * evaluated expression must be under 46 characters
2202
- */
2195
+ /** Unique identifier of each activation, by which rate limiter will count activations. */
2203
2196
  uniqueIdentifierExpression?: string | null;
2204
2197
  }
2205
2198
  interface ConditionExpressionGroup$1 {
2206
- /** expression group operator */
2199
+ /** Expression group operator. */
2207
2200
  operator?: Operator$1;
2208
- /**
2209
- * list of boolean expressions to be evaluated with the given operator
2210
- * examples - {{ true }}, {{ someBooleanField }}, {{ contains(["guid1...","guid2..."];formId) }}
2211
- */
2201
+ /** List of boolean expressions to be evaluated with the given operator. */
2212
2202
  booleanExpressions?: string[];
2213
2203
  }
2214
2204
  declare enum Operator$1 {
@@ -2231,77 +2221,56 @@ declare enum Type$1 {
2231
2221
  OUTPUT = "OUTPUT"
2232
2222
  }
2233
2223
  interface AppDefinedAction$1 {
2234
- /** Action app id */
2224
+ /** ID of the app that defines the action. */
2235
2225
  appId?: string;
2236
- /** Action key */
2226
+ /** Action key. */
2237
2227
  actionKey?: string;
2238
- /**
2239
- * Action input mapping, example:
2240
- * {
2241
- * "to": "{{ var(contact.email) }}",
2242
- * "subject": "Your registration to {{ var(eventName) }} is Confirmed",
2243
- * "body": "Hi {{ var(contact.name) }}, you are confirmed for the event"
2244
- * }
2245
- */
2228
+ /** Action input mapping. */
2246
2229
  inputMapping?: Record<string, any> | null;
2247
2230
  /**
2248
- * optional skip condition configuration - if this action should be skipped when the automation runs (following actions of a skipped action will still run)
2249
- * the action will be skipped if either of the expression groups evaluate to `true`
2250
- * the relation between the expression groups is an OR relation.
2231
+ * Array of conditions determining whether to skip the action in the automation flow.
2232
+ * The action will be skipped if any of the expression groups evaluate to `true`.
2233
+ * Actions following a skipped action will still run.
2251
2234
  */
2252
2235
  skipConditionOrExpressionGroups?: ConditionExpressionGroup$1[];
2253
- /** actions to run in parallel after this action finishes */
2236
+ /** List of IDs of actions to run in parallel once the action completes. */
2254
2237
  postActionIds?: string[];
2255
2238
  }
2256
2239
  interface ConditionAction$1 {
2257
- /**
2258
- * the condition evaluates to `true` if either of the expression groups evaluate to `true`
2259
- * the relation between the expression groups is an OR relation.
2260
- */
2240
+ /** The condition evaluates to `true` if either of the expression groups evaluate to `true`. */
2261
2241
  orExpressionGroups?: ConditionExpressionGroup$1[];
2262
- /** actions to run when the entire condition is evaluated to `true` */
2242
+ /** List of IDs of actions to run when the entire condition is evaluated to `true`. */
2263
2243
  truePostActionIds?: string[];
2264
- /** actions to run when the entire condition is evaluated to `false` */
2244
+ /** List of IDs of actions to run when the entire condition is evaluated to `false`. */
2265
2245
  falsePostActionIds?: string[];
2266
2246
  }
2267
2247
  interface DelayAction$1 {
2268
- /**
2269
- * optional - expression for amount of time to wait (in selected time unit) - from a specific date or from the time the action is executed
2270
- * offsetExpression: "{{5}}" + timeUnit: Days - to wait for 5 days from the time the delay was invoked
2271
- * or, offsetExpression: "{{5}}" + timeUnit: Days + dueDateEpochExpression: "{{someDateField}}" - to wait for 5 days from the time date in "someDateField" field in the payload
2272
- * or, offsetExpression: "{{ someNumberField }}" + timeUnit: Minutes, to wait for someNumberField's value in minutes
2273
- */
2248
+ /** Value expressing the amount of time to wait from a specific date or from the time the action is executed. */
2274
2249
  offsetExpression?: string | null;
2275
- /** Time unit for delay offset */
2250
+ /** Time unit for delay offset. */
2276
2251
  offsetTimeUnit?: TimeUnit$1;
2277
2252
  /**
2278
- * optional - expression of the due date to wait until, if an offset was defined, it will be calculated from this date
2279
- * number of milliseconds since the Unix Epoch (1 January, 1970 UTC)
2280
- * for example - "{{ 18238348023423 }}", or "{{ someEpochFromPayloadField }}" / "{{ contact.birthdate }}"
2253
+ * The action due date. If defined without an offset, the automation will wait until this date to execute the next step.
2254
+ * If an offset is defined, it's calculated from this date.
2255
+ * The date is expressed in the number of milliseconds since the Unix Epoch (1 January, 1970 UTC).
2281
2256
  */
2282
2257
  dueDateEpochExpression?: string | null;
2283
- /** actions to run in parallel after this action finishes */
2258
+ /** List of IDs of actions to run in parallel after the delay. */
2284
2259
  postActionIds?: string[];
2285
2260
  }
2286
2261
  interface RateLimitAction$1 {
2287
- /**
2288
- * Maximum number of activations expression. the expression will need to be parsed to Int on runtime
2289
- * for example - "{{ 1 }}" to set max activations to 1, or "{{ var(someNumberField) }}" to set max activations as the value of "someNumberField" from the payload
2290
- */
2262
+ /** The maximum number of activations allowed for the action. */
2291
2263
  maxActivationsExpression?: string;
2292
2264
  /**
2293
- * Duration of the rate limiting window (in selected time unit) expression for rate limiter, if empty then no time limit. the expression will need to be parsed to Int on runtime
2294
- * for example - "{{ 10 }}" to set timeframe to be 10 minutes, or {{ var(someNumberField) }} to set timeframe in minutes as the value of "someNumberField" from the payload
2265
+ * Duration of the rate limiting window, expressed in selected time unit.
2266
+ * If no value is set, then there is no time limit on the rate limiter.
2295
2267
  */
2296
2268
  rateLimitDurationExpression?: string | null;
2297
- /** Time unit for the rate limit duration */
2269
+ /** Time unit for the rate limit duration. */
2298
2270
  rateLimitDurationTimeUnit?: TimeUnit$1;
2299
- /**
2300
- * Unique identifier of each activation by which rate limiter will count activations, expected return type is string
2301
- * for example - {{ var(contact.id) }} to set the unique identifier as the value of "contact.id" from the payload
2302
- */
2271
+ /** Unique identifier of each activation by which rate limiter counts activations. */
2303
2272
  uniqueIdentifierExpression?: string | null;
2304
- /** actions to run in parallel after this action finishes */
2273
+ /** List of IDs of actions to run in parallel once the action completes. */
2305
2274
  postActionIds?: string[];
2306
2275
  }
2307
2276
  declare enum Status$1 {
@@ -2313,89 +2282,52 @@ declare enum Status$1 {
2313
2282
  INACTIVE = "INACTIVE"
2314
2283
  }
2315
2284
  interface Trigger$1 {
2316
- /** Trigger Application id */
2285
+ /** ID of the app that defines the trigger. */
2317
2286
  appId?: string;
2318
- /** Trigger key */
2287
+ /** Trigger key. */
2319
2288
  triggerKey?: string;
2320
2289
  /**
2321
- * optional - list of filters on schema fields
2322
- * the relation between the filter expressions is an AND relation.
2323
- * all filter expressions must be evaluated to `true` for a given payload in order for the automation to be executed
2290
+ * List of filters on schema fields.
2291
+ * In order for the automation to run, all filter expressions must evaluate to `true` for a given payload.
2324
2292
  */
2325
2293
  filters?: Filter$1[];
2326
- /** optional - future date trigger activation offset */
2294
+ /** Defines the time offset between the trigger date and when the automation runs. */
2327
2295
  scheduledEventOffset?: FutureDateActivationOffset$1;
2328
- /** optional - rate limiting configuration */
2296
+ /** Limits the number of times an automation can be triggered. */
2329
2297
  rateLimit?: RateLimit$1;
2330
2298
  automationConfigMapping?: Record<string, any> | null;
2331
2299
  }
2332
2300
  interface Action$1 extends ActionInfoOneOf$1 {
2333
- /** App defined Action (via RPC, HTTP or Velo) */
2301
+ /** Action defined by an app (via RPC, HTTP or Velo). */
2334
2302
  appDefinedInfo?: AppDefinedAction$1;
2335
- /** Condition action */
2303
+ /** Condition action. */
2336
2304
  conditionInfo?: ConditionAction$1;
2337
- /** Delay action */
2305
+ /** Delay action. */
2338
2306
  delayInfo?: DelayAction$1;
2339
- /** Rate limiting action */
2307
+ /** Rate-limiting action. */
2340
2308
  rateLimitInfo?: RateLimitAction$1;
2341
- /** Action id, if not specified, will be generated */
2309
+ /** Action ID. If not specified, a new ID is generated. */
2342
2310
  id?: string | null;
2343
- /** Type of the action */
2311
+ /** Action type. */
2344
2312
  type?: Type$1;
2345
2313
  /**
2346
- * Human readable name for the action (may only contain alphanumeric characters and underscores) to differentiate from other actions of the same kind.
2347
- * if the action has output, the output will be available in the payload under this name, otherwise it will be concatenated to the payload as is
2348
- * without namespaces (or in case of exact same namespaces), if the user has multiple actions of the same kind (appId+actionKey), the output will be overwritten.
2349
- *
2350
- * for example, given:
2351
- * - if the action output looks like this - { "message": "hello" }
2352
- * - the namespace is "action_1"
2353
- * - the trigger payload looks like this - { "someField": "50", "someBoolean": true }
2354
- *
2355
- * the payload will look like this:
2356
- * {
2357
- * "someField": "50",
2358
- * "someBoolean": true,
2359
- * "action_1": {
2360
- * "message": "hello"
2361
- * }
2362
- * }
2363
- *
2364
- * given the following Automation configuration:
2365
- *
2366
- * (Trigger A)
2367
- * |
2368
- * (Action B) // namespace = "action_b_1"
2369
- * |
2370
- * (Action B) // namespace = "action_b_2"
2371
- * |
2372
- * (Action C)
2373
- *
2374
- *
2375
- * the available fields that Action C will be able to use to map to it's input fields will be:
2376
- * {
2377
- * "someField": "50",
2378
- * "someBoolean": true,
2379
- * "action_b_1": {
2380
- * "message": "hello"
2381
- * },
2382
- * "action_b_2": {
2383
- * "message": "hello"
2384
- * }
2385
- * }
2386
- * so the user can select which specific action output to use (action_b_1.message or action_b_2.message, in the case above)
2314
+ * Human-readable name to differentiate the action from other actions of the same type.
2315
+ * The name can contain only alphanumeric characters and underscores. If not provided, a namespace in the form `actionkey-indexOfAction` is
2316
+ * generated automatically.
2317
+ * If the action has output, the output will be available in the payload under this name.
2318
+ * If the user has multiple actions with the same appId and actionKey, previous action output will be overwritten.
2387
2319
  */
2388
2320
  namespace?: string | null;
2389
2321
  }
2390
2322
  /** @oneof */
2391
2323
  interface ActionInfoOneOf$1 {
2392
- /** App defined Action (via RPC, HTTP or Velo) */
2324
+ /** Action defined by an app (via RPC, HTTP or Velo). */
2393
2325
  appDefinedInfo?: AppDefinedAction$1;
2394
- /** Condition action */
2326
+ /** Condition action. */
2395
2327
  conditionInfo?: ConditionAction$1;
2396
- /** Delay action */
2328
+ /** Delay action. */
2397
2329
  delayInfo?: DelayAction$1;
2398
- /** Rate limiting action */
2330
+ /** Rate-limiting action. */
2399
2331
  rateLimitInfo?: RateLimitAction$1;
2400
2332
  }
2401
2333
  declare enum Origin$1 {
@@ -2411,18 +2343,22 @@ declare enum Origin$1 {
2411
2343
  DRAFT = "DRAFT"
2412
2344
  }
2413
2345
  interface ApplicationOrigin$1 {
2414
- /** identifier for the application */
2346
+ /** Application ID. */
2415
2347
  appId?: string;
2416
2348
  }
2417
2349
  interface PreinstalledOrigin$1 {
2418
- /** identifier for the application */
2350
+ /** ID of the app that defines the preinstalled automation. */
2419
2351
  appId?: string;
2420
- /** application component ID */
2352
+ /** Application component ID. */
2421
2353
  componentId?: string;
2422
- /** application component Version */
2354
+ /** Application component version. */
2423
2355
  componentVersion?: number;
2424
2356
  /**
2425
- * is this a user modified preinstalled automation (on a specific site) or the original one
2357
+ * Whether the automation is an override automation. If the user modifies the preinstalled automation installed on their site, a site-specific
2358
+ * automation is created that overrides the original one. If the user makes no modifications this boolean is set to `false` and the original
2359
+ * preinstalled automation is used.
2360
+ *
2361
+ * Default: `false`
2426
2362
  * @readonly
2427
2363
  */
2428
2364
  override?: boolean | null;
@@ -2432,15 +2368,27 @@ interface DraftOrigin$1 {
2432
2368
  parentId?: string | null;
2433
2369
  }
2434
2370
  interface AutomationSettings$1 {
2435
- /** sets if the automation is hidden from users */
2371
+ /**
2372
+ * Whether the automation is hidden from users.
2373
+ * Default: `false`
2374
+ */
2436
2375
  hidden?: boolean;
2437
- /** sets if the automation is readonly */
2376
+ /**
2377
+ * Whether the automation is read-only.
2378
+ * Default: `false`
2379
+ */
2438
2380
  readonly?: boolean;
2439
- /** sets if deleting the automation is disabled */
2381
+ /**
2382
+ * Whether the option to delete the automation from the site is disabled.
2383
+ * Default: `false`
2384
+ */
2440
2385
  disableDelete?: boolean;
2441
- /** sets if changing the automation status is disabled (from active to inactive and vice versa) */
2386
+ /**
2387
+ * Whether the option to change the automation status (from active to inactive and vice versa) is disabled.
2388
+ * Default: `false`
2389
+ */
2442
2390
  disableStatusChange?: boolean;
2443
- /** Automation's action settings */
2391
+ /** Automation action settings. */
2444
2392
  actionSettings?: ActionSettings$1;
2445
2393
  }
2446
2394
  interface CreateAutomationRequest$1 {
@@ -2448,45 +2396,45 @@ interface CreateAutomationRequest$1 {
2448
2396
  automation: Automation$1;
2449
2397
  }
2450
2398
  interface CreateAutomationResponse$1 {
2451
- /** The created Automation. */
2399
+ /** The created automation. */
2452
2400
  automation?: Automation$1;
2453
2401
  }
2454
2402
  interface GetAutomationRequest$1 {
2455
- /** ID of the Automation to retrieve. */
2403
+ /** Automation ID. */
2456
2404
  automationId: string;
2457
- /** Automation Origin */
2405
+ /** Automation origin. */
2458
2406
  origin?: Origin$1;
2459
2407
  }
2460
2408
  interface GetAutomationResponse$1 {
2461
- /** The requested Automation. */
2409
+ /** The requested automation. */
2462
2410
  automation?: Automation$1;
2463
2411
  }
2464
2412
  interface UpdateAutomationRequest$1 {
2465
- /** Automation to be updated, may be partial. */
2413
+ /** Automation to update. */
2466
2414
  automation: Automation$1;
2467
2415
  }
2468
2416
  interface UpdateAutomationResponse$1 {
2469
- /** Updated Automation. */
2417
+ /** Updated automation. */
2470
2418
  automation?: Automation$1;
2471
2419
  }
2472
2420
  interface DeleteAutomationRequest$1 {
2473
- /** Id of the Automation to delete. */
2421
+ /** Automation ID. */
2474
2422
  automationId: string;
2475
2423
  }
2476
2424
  interface DeleteAutomationResponse$1 {
2477
2425
  }
2478
2426
  interface BulkDeleteAutomationsRequest$1 {
2479
- /** Automation IDs to delete */
2427
+ /** Automation IDs to delete. */
2480
2428
  automationIds: string[];
2481
2429
  }
2482
2430
  interface BulkDeleteAutomationsResponse$1 {
2483
- /** bulk delete results */
2431
+ /** Deleted automations results. */
2484
2432
  results?: BulkDeleteResult$1[];
2485
- /** bulk delete metadata */
2433
+ /** Metadata for the API call. */
2486
2434
  bulkActionMetadata?: BulkActionMetadata$1;
2487
2435
  }
2488
2436
  interface BulkDeleteResult$1 {
2489
- /** bulk delete item metadata */
2437
+ /** Metadata for the item deletion. */
2490
2438
  itemMetadata?: ItemMetadata$1;
2491
2439
  }
2492
2440
  interface ItemMetadata$1 {
@@ -2564,9 +2512,9 @@ interface CursorPaging$1 {
2564
2512
  cursor?: string | null;
2565
2513
  }
2566
2514
  interface QueryAutomationsResponse$1 {
2567
- /** List of Automations. */
2515
+ /** List of automations. */
2568
2516
  automations?: Automation$1[];
2569
- /** Paging metadata */
2517
+ /** Paging metadata. */
2570
2518
  pagingMetadata?: CursorPagingMetadata$1;
2571
2519
  }
2572
2520
  interface CursorPagingMetadata$1 {
@@ -2589,42 +2537,47 @@ interface Cursors$1 {
2589
2537
  prev?: string | null;
2590
2538
  }
2591
2539
  interface ValidateAutomationRequest$1 {
2592
- /** Automation to validate */
2540
+ /** Automation to validate. */
2593
2541
  automation: Automation$1;
2594
- /** optional validation settings */
2542
+ /** Settings to customize the validation. */
2595
2543
  validationSettings?: ValidationSettings$1;
2596
2544
  }
2597
2545
  interface ValidationSettings$1 {
2598
2546
  /**
2599
- * specific actions to include in the validation
2600
- * if non empty - only the specific actions would be validated (trigger excluded)
2601
- * if empty, the entire automation will be validated (trigger included)
2547
+ * List of specific actions to validate. Only the actions in the list are validated. In this case, triggers are not validated.
2548
+ *
2549
+ * If the list is empty, the entire automation is validated, including triggers.
2550
+ *
2551
+ * Default: Empty.
2602
2552
  */
2603
2553
  actionIds?: string[];
2604
- /** whether or not to skip provider validations (default: false) */
2554
+ /**
2555
+ * Whether to skip provider validations.
2556
+ * Default: `false`
2557
+ */
2605
2558
  skipProviderValidations?: boolean;
2606
2559
  }
2607
2560
  interface ValidateAutomationResponse$1 {
2608
- /** is the Automation valid */
2561
+ /** Whether the automation is valid. */
2609
2562
  valid?: boolean;
2610
- /** list of validation errors for the automation Trigger */
2563
+ /** List of validation errors for the automation trigger. */
2611
2564
  triggerValidationErrors?: TriggerValidationError$1[];
2612
- /** list of validation information for the automation Actions */
2565
+ /** List of validation information for the automation actions. */
2613
2566
  actionValidationInfo?: ActionValidationInfo$1[];
2614
2567
  }
2615
2568
  interface TriggerValidationError$1 extends TriggerValidationErrorErrorOneOf$1 {
2616
- /** trigger configuration error */
2569
+ /** Trigger configuration error. */
2617
2570
  configurationError?: TriggerConfigurationError$1;
2618
- /** provider configuration error */
2571
+ /** Provider configuration error. */
2619
2572
  providerConfigurationError?: ProviderConfigurationError$1;
2620
- /** validation error type */
2573
+ /** Validation error type. */
2621
2574
  errorType?: TriggerValidationErrorValidationErrorType$1;
2622
2575
  }
2623
2576
  /** @oneof */
2624
2577
  interface TriggerValidationErrorErrorOneOf$1 {
2625
- /** trigger configuration error */
2578
+ /** Trigger configuration error. */
2626
2579
  configurationError?: TriggerConfigurationError$1;
2627
- /** provider configuration error */
2580
+ /** Provider configuration error. */
2628
2581
  providerConfigurationError?: ProviderConfigurationError$1;
2629
2582
  }
2630
2583
  declare enum TriggerValidationErrorValidationErrorType$1 {
@@ -2633,9 +2586,9 @@ declare enum TriggerValidationErrorValidationErrorType$1 {
2633
2586
  PROVIDER_ERROR = "PROVIDER_ERROR"
2634
2587
  }
2635
2588
  interface TriggerConfigurationError$1 {
2636
- /** trigger error type */
2589
+ /** Trigger error type. */
2637
2590
  errorType?: TriggerErrorType$1;
2638
- /** optional - related filter field key */
2591
+ /** Related filter field key. */
2639
2592
  filterFieldKey?: string | null;
2640
2593
  }
2641
2594
  declare enum TriggerErrorType$1 {
@@ -2661,28 +2614,28 @@ interface ProviderConfigurationError$1 {
2661
2614
  title?: string;
2662
2615
  }
2663
2616
  interface ActionValidationInfo$1 {
2664
- /** the id of the action in the automation */
2617
+ /** Action ID. */
2665
2618
  actionId?: string | null;
2666
- /** the id of the app defining the action */
2619
+ /** ID of the app that defines the action. */
2667
2620
  appId?: string;
2668
- /** human readable identifier of the action per app */
2621
+ /** Human-readable action identifier. */
2669
2622
  actionKey?: string;
2670
- /** list of action validation errors */
2623
+ /** List of action validation errors. */
2671
2624
  validationErrors?: ActionValidationError$1[];
2672
2625
  }
2673
2626
  interface ActionValidationError$1 extends ActionValidationErrorErrorOneOf$1 {
2674
- /** action configuration error */
2627
+ /** Action configuration error. */
2675
2628
  configurationError?: ActionConfigurationError$1;
2676
- /** provider configuration error */
2629
+ /** Provider configuration error. */
2677
2630
  providerConfigurationError?: ProviderConfigurationError$1;
2678
- /** validation error type */
2631
+ /** Validation error type. */
2679
2632
  errorType?: ValidationErrorType$1;
2680
2633
  }
2681
2634
  /** @oneof */
2682
2635
  interface ActionValidationErrorErrorOneOf$1 {
2683
- /** action configuration error */
2636
+ /** Action configuration error. */
2684
2637
  configurationError?: ActionConfigurationError$1;
2685
- /** provider configuration error */
2638
+ /** Provider configuration error. */
2686
2639
  providerConfigurationError?: ProviderConfigurationError$1;
2687
2640
  }
2688
2641
  declare enum ValidationErrorType$1 {
@@ -2691,9 +2644,9 @@ declare enum ValidationErrorType$1 {
2691
2644
  PROVIDER_ERROR = "PROVIDER_ERROR"
2692
2645
  }
2693
2646
  interface ActionConfigurationError$1 {
2694
- /** action error type */
2647
+ /** Action error type. */
2695
2648
  errorType?: ActionErrorType$1;
2696
- /** optional - related field key */
2649
+ /** Related field key. */
2697
2650
  fieldKey?: string | null;
2698
2651
  }
2699
2652
  declare enum ActionErrorType$1 {
@@ -2833,7 +2786,6 @@ interface ValidateAutomationResponseNonNullableFields$1 {
2833
2786
  actionValidationInfo: ActionValidationInfoNonNullableFields$1[];
2834
2787
  }
2835
2788
 
2836
- /** Automation */
2837
2789
  interface Automation extends AutomationOriginInfoOneOf {
2838
2790
  /** Application info */
2839
2791
  applicationInfo?: ApplicationOrigin;
@@ -2847,43 +2799,43 @@ interface Automation extends AutomationOriginInfoOneOf {
2847
2799
  */
2848
2800
  _id?: string | null;
2849
2801
  /**
2850
- * Revision number, which increments by 1 each time the Automation is updated.
2802
+ * Revision number, which increments by 1 each time the automation is updated.
2851
2803
  * To prevent conflicting changes,
2852
- * the current revision must be passed when updating the Automation.
2804
+ * the current revision must be passed when updating the automation.
2853
2805
  *
2854
- * Ignored when creating an Automation.
2806
+ * Ignored when creating an automation.
2855
2807
  * @readonly
2856
2808
  */
2857
2809
  revision?: string | null;
2858
2810
  /**
2859
- * information about the creator of the automation
2811
+ * Information about the creator of the automation.
2860
2812
  * @readonly
2861
2813
  */
2862
2814
  createdBy?: AuditInfo;
2863
2815
  /**
2864
- * Date and time the Automation was created.
2816
+ * Date and time the automation was created.
2865
2817
  * @readonly
2866
2818
  */
2867
2819
  _createdDate?: Date;
2868
2820
  /**
2869
- * information about who updated of the automation
2821
+ * The entity that last updated the automation.
2870
2822
  * @readonly
2871
2823
  */
2872
2824
  updatedBy?: AuditInfo;
2873
2825
  /**
2874
- * Date and time the Automation was last updated.
2826
+ * Date and time the automation was last updated.
2875
2827
  * @readonly
2876
2828
  */
2877
2829
  _updatedDate?: Date;
2878
- /** Automation name */
2830
+ /** Automation name that is displayed on the user's site. */
2879
2831
  name?: string;
2880
- /** Automation description */
2832
+ /** Automation description. */
2881
2833
  description?: string | null;
2882
- /** Automation runtime configuration */
2834
+ /** Object that defines the automation's trigger, actions, and activation status. */
2883
2835
  configuration?: AutomationConfiguration;
2884
- /** Origin type */
2836
+ /** Defines how the automation was added to the site. */
2885
2837
  origin?: Origin;
2886
- /** Automation settings */
2838
+ /** Automation settings. */
2887
2839
  settings?: AutomationSettings;
2888
2840
  }
2889
2841
  /** @oneof */
@@ -2896,39 +2848,45 @@ interface AutomationOriginInfoOneOf {
2896
2848
  draftInfo?: DraftOrigin;
2897
2849
  }
2898
2850
  interface ActionSettings {
2899
- /** list of permanent action ids of actions that cannot be deleted (default - empty, all actions are deletable by default) */
2851
+ /**
2852
+ * List of actions that cannot be deleted.
2853
+ * Default: Empty. All actions are deletable by default.
2854
+ */
2900
2855
  permanentActionIds?: string[];
2901
- /** list of readonly action ids, (default - empty, all actions are editable by default) */
2856
+ /**
2857
+ * List of actions that cannot be edited.
2858
+ * Default: Empty. All actions are editable by default.
2859
+ */
2902
2860
  readonlyActionIds?: string[];
2903
- /** sets if adding a delay action is disabled for this automation */
2861
+ /** Whether the option to add a delay is disabled for the automation. */
2904
2862
  disableDelayAddition?: boolean;
2905
- /** sets if adding a condition action is disabled for this automation */
2863
+ /** Whether the option to add a condition is disabled for the automation. */
2906
2864
  disableConditionAddition?: boolean;
2907
2865
  }
2908
2866
  interface AuditInfo extends AuditInfoIdOneOf {
2909
- /** user identifier */
2867
+ /** User ID. */
2910
2868
  userId?: string;
2911
- /** application identifier */
2869
+ /** Application ID. */
2912
2870
  appId?: string;
2913
2871
  }
2914
2872
  /** @oneof */
2915
2873
  interface AuditInfoIdOneOf {
2916
- /** user identifier */
2874
+ /** User ID. */
2917
2875
  userId?: string;
2918
- /** application identifier */
2876
+ /** Application ID. */
2919
2877
  appId?: string;
2920
2878
  }
2921
2879
  /** Automation runtime configuration */
2922
2880
  interface AutomationConfiguration {
2923
- /** Automation's Status */
2881
+ /** Status of the automation on the site. */
2924
2882
  status?: Status;
2925
- /** Trigger configuration */
2883
+ /** Automation trigger configuration. */
2926
2884
  trigger?: Trigger;
2927
- /** actions that run in parallel after the trigger */
2885
+ /** 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. */
2928
2886
  rootActionIds?: string[];
2929
2887
  /**
2930
- * map of all actions by actionId
2931
- * The key is the actionId of the action, and the value is the action configuration
2888
+ * Map of all actions that the automation may execute.
2889
+ * The key is the action ID, and the value is the action configuration.
2932
2890
  */
2933
2891
  actions?: Record<string, Action>;
2934
2892
  }
@@ -2941,51 +2899,36 @@ declare enum TimeUnit {
2941
2899
  MONTHS = "MONTHS"
2942
2900
  }
2943
2901
  interface Filter {
2944
- /** the filter identifier */
2902
+ /** Filter ID. */
2945
2903
  _id?: string;
2946
- /** the field key from the schema, for example "formId" */
2904
+ /** Field key from the payload schema, for example "formId". */
2947
2905
  fieldKey?: string;
2948
- /** filter expression that evaluates to a boolean, for example - {{ contains(["guid1","guid2"];formId) }} */
2906
+ /** Filter expression that evaluates to a boolean. */
2949
2907
  filterExpression?: string;
2950
2908
  }
2951
2909
  interface FutureDateActivationOffset {
2952
2910
  /**
2953
- * expression of offset before the trigger's time (in selected time unit), when the Automation should run
2954
- * only allows negative offset from the trigger's date (before the trigger), positive offset should be achieved via offset delay action
2955
- * preScheduledEventOffsetExpression: "{{5}}" + timeUnit: Days - to run the Automation 5 days before the trigger's date
2956
- * or, preScheduledEventOffsetExpression: "{{ someNumberField }}" + timeUnit: Minutes, to run the Automation someNumberField's value in minutes before the trigger's date
2911
+ * The offset value. The value is always taken as negative, so that the automation runs before the trigger date.
2912
+ * To create an offset that causes the automation to run after the trigger date, use a delay action.
2957
2913
  */
2958
2914
  preScheduledEventOffsetExpression?: string;
2959
- /** Time unit for the scheduled event offset */
2915
+ /** Time unit for the scheduled event offset. */
2960
2916
  scheduledEventOffsetTimeUnit?: TimeUnit;
2961
2917
  }
2962
2918
  interface RateLimit {
2963
- /**
2964
- * Maximum number of activations expression. the expression will need to be parsed to Int on runtime
2965
- * for example - "{{ 1 }}" to set max activations to 1, or "{{ var(someNumberField) }}" to set max activations as the value of "someNumberField" from the payload
2966
- */
2919
+ /** Value expressing the maximum number of times the trigger can be activated. */
2967
2920
  maxActivationsExpression?: string;
2968
- /**
2969
- * Duration of the rate limiting window (in selected time unit) expression for rate limiter, if empty then no time limit. the expression will need to be parsed to Int on runtime
2970
- * for example - "{{ 10 }}" to set timeframe to be 10 minutes, or {{ var(someNumberField) }} to set timeframe in minutes as the value of "someNumberField" from the payload
2971
- */
2921
+ /** Duration of the rate limiting window in the selected time unit. If no value is set, the rate limit is permanent. */
2972
2922
  durationExpression?: string | null;
2973
- /** Time unit for the rate limit duration */
2923
+ /** Time unit for the rate limit duration. */
2974
2924
  durationTimeUnit?: TimeUnit;
2975
- /**
2976
- * Unique identifier of each activation by which rate limiter will count activations, expected return type is string
2977
- * for example - {{ var(contact.id) }} to set the unique identifier as the value of "contact.id" from the payload
2978
- * evaluated expression must be under 46 characters
2979
- */
2925
+ /** Unique identifier of each activation, by which rate limiter will count activations. */
2980
2926
  uniqueIdentifierExpression?: string | null;
2981
2927
  }
2982
2928
  interface ConditionExpressionGroup {
2983
- /** expression group operator */
2929
+ /** Expression group operator. */
2984
2930
  operator?: Operator;
2985
- /**
2986
- * list of boolean expressions to be evaluated with the given operator
2987
- * examples - {{ true }}, {{ someBooleanField }}, {{ contains(["guid1...","guid2..."];formId) }}
2988
- */
2931
+ /** List of boolean expressions to be evaluated with the given operator. */
2989
2932
  booleanExpressions?: string[];
2990
2933
  }
2991
2934
  declare enum Operator {
@@ -3008,77 +2951,56 @@ declare enum Type {
3008
2951
  OUTPUT = "OUTPUT"
3009
2952
  }
3010
2953
  interface AppDefinedAction {
3011
- /** Action app id */
2954
+ /** ID of the app that defines the action. */
3012
2955
  appId?: string;
3013
- /** Action key */
2956
+ /** Action key. */
3014
2957
  actionKey?: string;
3015
- /**
3016
- * Action input mapping, example:
3017
- * {
3018
- * "to": "{{ var(contact.email) }}",
3019
- * "subject": "Your registration to {{ var(eventName) }} is Confirmed",
3020
- * "body": "Hi {{ var(contact.name) }}, you are confirmed for the event"
3021
- * }
3022
- */
2958
+ /** Action input mapping. */
3023
2959
  inputMapping?: Record<string, any> | null;
3024
2960
  /**
3025
- * optional skip condition configuration - if this action should be skipped when the automation runs (following actions of a skipped action will still run)
3026
- * the action will be skipped if either of the expression groups evaluate to `true`
3027
- * the relation between the expression groups is an OR relation.
2961
+ * Array of conditions determining whether to skip the action in the automation flow.
2962
+ * The action will be skipped if any of the expression groups evaluate to `true`.
2963
+ * Actions following a skipped action will still run.
3028
2964
  */
3029
2965
  skipConditionOrExpressionGroups?: ConditionExpressionGroup[];
3030
- /** actions to run in parallel after this action finishes */
2966
+ /** List of IDs of actions to run in parallel once the action completes. */
3031
2967
  postActionIds?: string[];
3032
2968
  }
3033
2969
  interface ConditionAction {
3034
- /**
3035
- * the condition evaluates to `true` if either of the expression groups evaluate to `true`
3036
- * the relation between the expression groups is an OR relation.
3037
- */
2970
+ /** The condition evaluates to `true` if either of the expression groups evaluate to `true`. */
3038
2971
  orExpressionGroups?: ConditionExpressionGroup[];
3039
- /** actions to run when the entire condition is evaluated to `true` */
2972
+ /** List of IDs of actions to run when the entire condition is evaluated to `true`. */
3040
2973
  truePostActionIds?: string[];
3041
- /** actions to run when the entire condition is evaluated to `false` */
2974
+ /** List of IDs of actions to run when the entire condition is evaluated to `false`. */
3042
2975
  falsePostActionIds?: string[];
3043
2976
  }
3044
2977
  interface DelayAction {
3045
- /**
3046
- * optional - expression for amount of time to wait (in selected time unit) - from a specific date or from the time the action is executed
3047
- * offsetExpression: "{{5}}" + timeUnit: Days - to wait for 5 days from the time the delay was invoked
3048
- * or, offsetExpression: "{{5}}" + timeUnit: Days + dueDateEpochExpression: "{{someDateField}}" - to wait for 5 days from the time date in "someDateField" field in the payload
3049
- * or, offsetExpression: "{{ someNumberField }}" + timeUnit: Minutes, to wait for someNumberField's value in minutes
3050
- */
2978
+ /** Value expressing the amount of time to wait from a specific date or from the time the action is executed. */
3051
2979
  offsetExpression?: string | null;
3052
- /** Time unit for delay offset */
2980
+ /** Time unit for delay offset. */
3053
2981
  offsetTimeUnit?: TimeUnit;
3054
2982
  /**
3055
- * optional - expression of the due date to wait until, if an offset was defined, it will be calculated from this date
3056
- * number of milliseconds since the Unix Epoch (1 January, 1970 UTC)
3057
- * for example - "{{ 18238348023423 }}", or "{{ someEpochFromPayloadField }}" / "{{ contact.birthdate }}"
2983
+ * The action due date. If defined without an offset, the automation will wait until this date to execute the next step.
2984
+ * If an offset is defined, it's calculated from this date.
2985
+ * The date is expressed in the number of milliseconds since the Unix Epoch (1 January, 1970 UTC).
3058
2986
  */
3059
2987
  dueDateEpochExpression?: string | null;
3060
- /** actions to run in parallel after this action finishes */
2988
+ /** List of IDs of actions to run in parallel after the delay. */
3061
2989
  postActionIds?: string[];
3062
2990
  }
3063
2991
  interface RateLimitAction {
3064
- /**
3065
- * Maximum number of activations expression. the expression will need to be parsed to Int on runtime
3066
- * for example - "{{ 1 }}" to set max activations to 1, or "{{ var(someNumberField) }}" to set max activations as the value of "someNumberField" from the payload
3067
- */
2992
+ /** The maximum number of activations allowed for the action. */
3068
2993
  maxActivationsExpression?: string;
3069
2994
  /**
3070
- * Duration of the rate limiting window (in selected time unit) expression for rate limiter, if empty then no time limit. the expression will need to be parsed to Int on runtime
3071
- * for example - "{{ 10 }}" to set timeframe to be 10 minutes, or {{ var(someNumberField) }} to set timeframe in minutes as the value of "someNumberField" from the payload
2995
+ * Duration of the rate limiting window, expressed in selected time unit.
2996
+ * If no value is set, then there is no time limit on the rate limiter.
3072
2997
  */
3073
2998
  rateLimitDurationExpression?: string | null;
3074
- /** Time unit for the rate limit duration */
2999
+ /** Time unit for the rate limit duration. */
3075
3000
  rateLimitDurationTimeUnit?: TimeUnit;
3076
- /**
3077
- * Unique identifier of each activation by which rate limiter will count activations, expected return type is string
3078
- * for example - {{ var(contact.id) }} to set the unique identifier as the value of "contact.id" from the payload
3079
- */
3001
+ /** Unique identifier of each activation by which rate limiter counts activations. */
3080
3002
  uniqueIdentifierExpression?: string | null;
3081
- /** actions to run in parallel after this action finishes */
3003
+ /** List of IDs of actions to run in parallel once the action completes. */
3082
3004
  postActionIds?: string[];
3083
3005
  }
3084
3006
  declare enum Status {
@@ -3090,89 +3012,52 @@ declare enum Status {
3090
3012
  INACTIVE = "INACTIVE"
3091
3013
  }
3092
3014
  interface Trigger {
3093
- /** Trigger Application id */
3015
+ /** ID of the app that defines the trigger. */
3094
3016
  appId?: string;
3095
- /** Trigger key */
3017
+ /** Trigger key. */
3096
3018
  triggerKey?: string;
3097
3019
  /**
3098
- * optional - list of filters on schema fields
3099
- * the relation between the filter expressions is an AND relation.
3100
- * all filter expressions must be evaluated to `true` for a given payload in order for the automation to be executed
3020
+ * List of filters on schema fields.
3021
+ * In order for the automation to run, all filter expressions must evaluate to `true` for a given payload.
3101
3022
  */
3102
3023
  filters?: Filter[];
3103
- /** optional - future date trigger activation offset */
3024
+ /** Defines the time offset between the trigger date and when the automation runs. */
3104
3025
  scheduledEventOffset?: FutureDateActivationOffset;
3105
- /** optional - rate limiting configuration */
3026
+ /** Limits the number of times an automation can be triggered. */
3106
3027
  rateLimit?: RateLimit;
3107
3028
  automationConfigMapping?: Record<string, any> | null;
3108
3029
  }
3109
3030
  interface Action extends ActionInfoOneOf {
3110
- /** App defined Action (via RPC, HTTP or Velo) */
3031
+ /** Action defined by an app (via RPC, HTTP or Velo). */
3111
3032
  appDefinedInfo?: AppDefinedAction;
3112
- /** Condition action */
3033
+ /** Condition action. */
3113
3034
  conditionInfo?: ConditionAction;
3114
- /** Delay action */
3035
+ /** Delay action. */
3115
3036
  delayInfo?: DelayAction;
3116
- /** Rate limiting action */
3037
+ /** Rate-limiting action. */
3117
3038
  rateLimitInfo?: RateLimitAction;
3118
- /** Action id, if not specified, will be generated */
3039
+ /** Action ID. If not specified, a new ID is generated. */
3119
3040
  _id?: string | null;
3120
- /** Type of the action */
3041
+ /** Action type. */
3121
3042
  type?: Type;
3122
3043
  /**
3123
- * Human readable name for the action (may only contain alphanumeric characters and underscores) to differentiate from other actions of the same kind.
3124
- * if the action has output, the output will be available in the payload under this name, otherwise it will be concatenated to the payload as is
3125
- * without namespaces (or in case of exact same namespaces), if the user has multiple actions of the same kind (appId+actionKey), the output will be overwritten.
3126
- *
3127
- * for example, given:
3128
- * - if the action output looks like this - { "message": "hello" }
3129
- * - the namespace is "action_1"
3130
- * - the trigger payload looks like this - { "someField": "50", "someBoolean": true }
3131
- *
3132
- * the payload will look like this:
3133
- * {
3134
- * "someField": "50",
3135
- * "someBoolean": true,
3136
- * "action_1": {
3137
- * "message": "hello"
3138
- * }
3139
- * }
3140
- *
3141
- * given the following Automation configuration:
3142
- *
3143
- * (Trigger A)
3144
- * |
3145
- * (Action B) // namespace = "action_b_1"
3146
- * |
3147
- * (Action B) // namespace = "action_b_2"
3148
- * |
3149
- * (Action C)
3150
- *
3151
- *
3152
- * the available fields that Action C will be able to use to map to it's input fields will be:
3153
- * {
3154
- * "someField": "50",
3155
- * "someBoolean": true,
3156
- * "action_b_1": {
3157
- * "message": "hello"
3158
- * },
3159
- * "action_b_2": {
3160
- * "message": "hello"
3161
- * }
3162
- * }
3163
- * so the user can select which specific action output to use (action_b_1.message or action_b_2.message, in the case above)
3044
+ * Human-readable name to differentiate the action from other actions of the same type.
3045
+ * The name can contain only alphanumeric characters and underscores. If not provided, a namespace in the form `actionkey-indexOfAction` is
3046
+ * generated automatically.
3047
+ * If the action has output, the output will be available in the payload under this name.
3048
+ * If the user has multiple actions with the same appId and actionKey, previous action output will be overwritten.
3164
3049
  */
3165
3050
  namespace?: string | null;
3166
3051
  }
3167
3052
  /** @oneof */
3168
3053
  interface ActionInfoOneOf {
3169
- /** App defined Action (via RPC, HTTP or Velo) */
3054
+ /** Action defined by an app (via RPC, HTTP or Velo). */
3170
3055
  appDefinedInfo?: AppDefinedAction;
3171
- /** Condition action */
3056
+ /** Condition action. */
3172
3057
  conditionInfo?: ConditionAction;
3173
- /** Delay action */
3058
+ /** Delay action. */
3174
3059
  delayInfo?: DelayAction;
3175
- /** Rate limiting action */
3060
+ /** Rate-limiting action. */
3176
3061
  rateLimitInfo?: RateLimitAction;
3177
3062
  }
3178
3063
  declare enum Origin {
@@ -3188,18 +3073,22 @@ declare enum Origin {
3188
3073
  DRAFT = "DRAFT"
3189
3074
  }
3190
3075
  interface ApplicationOrigin {
3191
- /** identifier for the application */
3076
+ /** Application ID. */
3192
3077
  appId?: string;
3193
3078
  }
3194
3079
  interface PreinstalledOrigin {
3195
- /** identifier for the application */
3080
+ /** ID of the app that defines the preinstalled automation. */
3196
3081
  appId?: string;
3197
- /** application component ID */
3082
+ /** Application component ID. */
3198
3083
  componentId?: string;
3199
- /** application component Version */
3084
+ /** Application component version. */
3200
3085
  componentVersion?: number;
3201
3086
  /**
3202
- * is this a user modified preinstalled automation (on a specific site) or the original one
3087
+ * Whether the automation is an override automation. If the user modifies the preinstalled automation installed on their site, a site-specific
3088
+ * automation is created that overrides the original one. If the user makes no modifications this boolean is set to `false` and the original
3089
+ * preinstalled automation is used.
3090
+ *
3091
+ * Default: `false`
3203
3092
  * @readonly
3204
3093
  */
3205
3094
  override?: boolean | null;
@@ -3209,15 +3098,27 @@ interface DraftOrigin {
3209
3098
  parentId?: string | null;
3210
3099
  }
3211
3100
  interface AutomationSettings {
3212
- /** sets if the automation is hidden from users */
3101
+ /**
3102
+ * Whether the automation is hidden from users.
3103
+ * Default: `false`
3104
+ */
3213
3105
  hidden?: boolean;
3214
- /** sets if the automation is readonly */
3106
+ /**
3107
+ * Whether the automation is read-only.
3108
+ * Default: `false`
3109
+ */
3215
3110
  readonly?: boolean;
3216
- /** sets if deleting the automation is disabled */
3111
+ /**
3112
+ * Whether the option to delete the automation from the site is disabled.
3113
+ * Default: `false`
3114
+ */
3217
3115
  disableDelete?: boolean;
3218
- /** sets if changing the automation status is disabled (from active to inactive and vice versa) */
3116
+ /**
3117
+ * Whether the option to change the automation status (from active to inactive and vice versa) is disabled.
3118
+ * Default: `false`
3119
+ */
3219
3120
  disableStatusChange?: boolean;
3220
- /** Automation's action settings */
3121
+ /** Automation action settings. */
3221
3122
  actionSettings?: ActionSettings;
3222
3123
  }
3223
3124
  interface CreateAutomationRequest {
@@ -3225,45 +3126,45 @@ interface CreateAutomationRequest {
3225
3126
  automation: Automation;
3226
3127
  }
3227
3128
  interface CreateAutomationResponse {
3228
- /** The created Automation. */
3129
+ /** The created automation. */
3229
3130
  automation?: Automation;
3230
3131
  }
3231
3132
  interface GetAutomationRequest {
3232
- /** ID of the Automation to retrieve. */
3133
+ /** Automation ID. */
3233
3134
  automationId: string;
3234
- /** Automation Origin */
3135
+ /** Automation origin. */
3235
3136
  origin?: Origin;
3236
3137
  }
3237
3138
  interface GetAutomationResponse {
3238
- /** The requested Automation. */
3139
+ /** The requested automation. */
3239
3140
  automation?: Automation;
3240
3141
  }
3241
3142
  interface UpdateAutomationRequest {
3242
- /** Automation to be updated, may be partial. */
3143
+ /** Automation to update. */
3243
3144
  automation: Automation;
3244
3145
  }
3245
3146
  interface UpdateAutomationResponse {
3246
- /** Updated Automation. */
3147
+ /** Updated automation. */
3247
3148
  automation?: Automation;
3248
3149
  }
3249
3150
  interface DeleteAutomationRequest {
3250
- /** Id of the Automation to delete. */
3151
+ /** Automation ID. */
3251
3152
  automationId: string;
3252
3153
  }
3253
3154
  interface DeleteAutomationResponse {
3254
3155
  }
3255
3156
  interface BulkDeleteAutomationsRequest {
3256
- /** Automation IDs to delete */
3157
+ /** Automation IDs to delete. */
3257
3158
  automationIds: string[];
3258
3159
  }
3259
3160
  interface BulkDeleteAutomationsResponse {
3260
- /** bulk delete results */
3161
+ /** Deleted automations results. */
3261
3162
  results?: BulkDeleteResult[];
3262
- /** bulk delete metadata */
3163
+ /** Metadata for the API call. */
3263
3164
  bulkActionMetadata?: BulkActionMetadata;
3264
3165
  }
3265
3166
  interface BulkDeleteResult {
3266
- /** bulk delete item metadata */
3167
+ /** Metadata for the item deletion. */
3267
3168
  itemMetadata?: ItemMetadata;
3268
3169
  }
3269
3170
  interface ItemMetadata {
@@ -3341,9 +3242,9 @@ interface CursorPaging {
3341
3242
  cursor?: string | null;
3342
3243
  }
3343
3244
  interface QueryAutomationsResponse {
3344
- /** List of Automations. */
3245
+ /** List of automations. */
3345
3246
  automations?: Automation[];
3346
- /** Paging metadata */
3247
+ /** Paging metadata. */
3347
3248
  pagingMetadata?: CursorPagingMetadata;
3348
3249
  }
3349
3250
  interface CursorPagingMetadata {
@@ -3366,42 +3267,47 @@ interface Cursors {
3366
3267
  prev?: string | null;
3367
3268
  }
3368
3269
  interface ValidateAutomationRequest {
3369
- /** Automation to validate */
3270
+ /** Automation to validate. */
3370
3271
  automation: Automation;
3371
- /** optional validation settings */
3272
+ /** Settings to customize the validation. */
3372
3273
  validationSettings?: ValidationSettings;
3373
3274
  }
3374
3275
  interface ValidationSettings {
3375
3276
  /**
3376
- * specific actions to include in the validation
3377
- * if non empty - only the specific actions would be validated (trigger excluded)
3378
- * if empty, the entire automation will be validated (trigger included)
3277
+ * List of specific actions to validate. Only the actions in the list are validated. In this case, triggers are not validated.
3278
+ *
3279
+ * If the list is empty, the entire automation is validated, including triggers.
3280
+ *
3281
+ * Default: Empty.
3379
3282
  */
3380
3283
  actionIds?: string[];
3381
- /** whether or not to skip provider validations (default: false) */
3284
+ /**
3285
+ * Whether to skip provider validations.
3286
+ * Default: `false`
3287
+ */
3382
3288
  skipProviderValidations?: boolean;
3383
3289
  }
3384
3290
  interface ValidateAutomationResponse {
3385
- /** is the Automation valid */
3291
+ /** Whether the automation is valid. */
3386
3292
  valid?: boolean;
3387
- /** list of validation errors for the automation Trigger */
3293
+ /** List of validation errors for the automation trigger. */
3388
3294
  triggerValidationErrors?: TriggerValidationError[];
3389
- /** list of validation information for the automation Actions */
3295
+ /** List of validation information for the automation actions. */
3390
3296
  actionValidationInfo?: ActionValidationInfo[];
3391
3297
  }
3392
3298
  interface TriggerValidationError extends TriggerValidationErrorErrorOneOf {
3393
- /** trigger configuration error */
3299
+ /** Trigger configuration error. */
3394
3300
  configurationError?: TriggerConfigurationError;
3395
- /** provider configuration error */
3301
+ /** Provider configuration error. */
3396
3302
  providerConfigurationError?: ProviderConfigurationError;
3397
- /** validation error type */
3303
+ /** Validation error type. */
3398
3304
  errorType?: TriggerValidationErrorValidationErrorType;
3399
3305
  }
3400
3306
  /** @oneof */
3401
3307
  interface TriggerValidationErrorErrorOneOf {
3402
- /** trigger configuration error */
3308
+ /** Trigger configuration error. */
3403
3309
  configurationError?: TriggerConfigurationError;
3404
- /** provider configuration error */
3310
+ /** Provider configuration error. */
3405
3311
  providerConfigurationError?: ProviderConfigurationError;
3406
3312
  }
3407
3313
  declare enum TriggerValidationErrorValidationErrorType {
@@ -3410,9 +3316,9 @@ declare enum TriggerValidationErrorValidationErrorType {
3410
3316
  PROVIDER_ERROR = "PROVIDER_ERROR"
3411
3317
  }
3412
3318
  interface TriggerConfigurationError {
3413
- /** trigger error type */
3319
+ /** Trigger error type. */
3414
3320
  errorType?: TriggerErrorType;
3415
- /** optional - related filter field key */
3321
+ /** Related filter field key. */
3416
3322
  filterFieldKey?: string | null;
3417
3323
  }
3418
3324
  declare enum TriggerErrorType {
@@ -3438,28 +3344,28 @@ interface ProviderConfigurationError {
3438
3344
  title?: string;
3439
3345
  }
3440
3346
  interface ActionValidationInfo {
3441
- /** the id of the action in the automation */
3347
+ /** Action ID. */
3442
3348
  actionId?: string | null;
3443
- /** the id of the app defining the action */
3349
+ /** ID of the app that defines the action. */
3444
3350
  appId?: string;
3445
- /** human readable identifier of the action per app */
3351
+ /** Human-readable action identifier. */
3446
3352
  actionKey?: string;
3447
- /** list of action validation errors */
3353
+ /** List of action validation errors. */
3448
3354
  validationErrors?: ActionValidationError[];
3449
3355
  }
3450
3356
  interface ActionValidationError extends ActionValidationErrorErrorOneOf {
3451
- /** action configuration error */
3357
+ /** Action configuration error. */
3452
3358
  configurationError?: ActionConfigurationError;
3453
- /** provider configuration error */
3359
+ /** Provider configuration error. */
3454
3360
  providerConfigurationError?: ProviderConfigurationError;
3455
- /** validation error type */
3361
+ /** Validation error type. */
3456
3362
  errorType?: ValidationErrorType;
3457
3363
  }
3458
3364
  /** @oneof */
3459
3365
  interface ActionValidationErrorErrorOneOf {
3460
- /** action configuration error */
3366
+ /** Action configuration error. */
3461
3367
  configurationError?: ActionConfigurationError;
3462
- /** provider configuration error */
3368
+ /** Provider configuration error. */
3463
3369
  providerConfigurationError?: ProviderConfigurationError;
3464
3370
  }
3465
3371
  declare enum ValidationErrorType {
@@ -3468,9 +3374,9 @@ declare enum ValidationErrorType {
3468
3374
  PROVIDER_ERROR = "PROVIDER_ERROR"
3469
3375
  }
3470
3376
  interface ActionConfigurationError {
3471
- /** action error type */
3377
+ /** Action error type. */
3472
3378
  errorType?: ActionErrorType;
3473
- /** optional - related field key */
3379
+ /** Related field key. */
3474
3380
  fieldKey?: string | null;
3475
3381
  }
3476
3382
  declare enum ActionErrorType {