Run a watch

POST /_watcher/watch/{id}/_execute

This API can be used to force execution of the watch outside of its triggering logic or to simulate the watch execution for debugging purposes.

For testing and debugging purposes, you also have fine-grained control on how the watch runs. You can run the watch without running all of its actions or alternatively by simulating them. You can also force execution by ignoring the watch condition and control whether a watch record would be written to the watch history after it runs.

You can use the run watch API to run watches that are not yet registered by specifying the watch definition inline. This serves as great tool for testing and debugging your watches prior to adding them to Watcher.

Path parameters

id string Required

Identifier for the watch.

Query parameters

debug boolean

Defines whether the watch runs in debug mode.

application/json

Body

action_modes object

Determines how to handle the watch actions as part of the watch execution.
Hide action_modes attribute Show action_modes attribute object
- * string Additional properties
  
  Values are simulate, force_simulate, execute, force_execute, or skip.
alternative_input object

When present, the watch uses this object as a payload instead of executing its own input.
Hide alternative_input attribute Show alternative_input attribute object
- * object Additional properties
  
  Additional properties are allowed.
ignore_condition boolean

When set to true, the watch execution uses the always condition. This can also be specified as an HTTP parameter.
record_execution boolean

When set to true, the watch record representing the watch execution result is persisted to the .watcher-history index for the current time. In addition, the status of the watch is updated, possibly throttling subsequent executions. This can also be specified as an HTTP parameter.
simulated_actions object

Additional properties are allowed.
Hide simulated_actions attributes Show simulated_actions attributes object
- actions array[string] Required
- all object Required
  
  Additional properties are allowed.
- use_all boolean Required
trigger_data object

Additional properties are allowed.
Hide trigger_data attributes Show trigger_data attributes object
- scheduled_time string | number Required
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
- triggered_time string | number
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
watch object

Additional properties are allowed.
Hide watch attributes Show watch attributes object
- actions object Required
  Hide actions attribute Show actions attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  Hide * attributes Show * attributes object
  
  action_type string
  
  Values are email, webhook, index, logging, slack, or pagerduty.
  
  condition object
  
  Additional properties are allowed.
  
  Hide condition attributes Show condition attributes object
  
  always object
  
  Additional properties are allowed.
  
  array_compare object
  
  Hide array_compare attribute Show array_compare attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  Hide * attribute Show * attribute object
  
  path string Required
  
  compare object
  
  Hide compare attribute Show compare attribute object
  
  * object Additional properties
  
  never object
  
  Additional properties are allowed.
  
  script object
  
  Additional properties are allowed.
  
  Hide script attributes Show script attributes object
  
  lang string
  
  params object
  
  Hide params attribute Show params attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  source string
  
  id string
  
  foreach string
  
  max_iterations number
  
  name string
  
  throttle_period string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  throttle_period_in_millis number
  
  Time unit for milliseconds
  
  transform object
  
  Additional properties are allowed.
  
  Hide transform attributes Show transform attributes object
  
  chain array[object]
  
  Additional properties are allowed.
  
  script object
  
  Additional properties are allowed.
  
  Hide script attributes Show script attributes object
  
  lang string
  
  params object
  
  Hide params attribute Show params attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  source string
  
  id string
  
  search object
  
  Additional properties are allowed.
  
  Hide search attributes Show search attributes object
  
  request object Required
  
  Additional properties are allowed.
  
  Hide request attributes Show request attributes object
  
  body object
  
  Additional properties are allowed.
  
  indices array[string]
  
  indices_options object
  
  Additional properties are allowed.
  
  search_type string
  
  Values are query_then_fetch or dfs_query_then_fetch.
  
  template object
  
  Additional properties are allowed.
  
  rest_total_hits_as_int boolean
  
  timeout string Required
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  index object
  
  Additional properties are allowed.
  
  Hide index attributes Show index attributes object
  
  index string Required
  
  doc_id string
  
  refresh string
  
  Values are true, false, or wait_for.
  
  op_type string
  
  Values are index or create.
  
  timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  execution_time_field string
  
  Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
  
  logging object
  
  Additional properties are allowed.
  
  Hide logging attributes Show logging attributes object
  
  level string
  
  text string Required
  
  category string
  
  email object
  
  Additional properties are allowed.
  
  Hide email attributes Show email attributes object
  
  id string
  
  bcc array[string]
  
  body object
  
  Additional properties are allowed.
  
  Hide body attributes Show body attributes object
  
  html string
  
  text string
  
  cc array[string]
  
  from string
  
  priority string
  
  Values are lowest, low, normal, high, or highest.
  
  reply_to array[string]
  
  sent_date string
  
  subject string Required
  
  to array[string] Required
  
  attachments object
  
  Hide attachments attribute Show attachments attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  pagerduty object
  
  Additional properties are allowed.
  
  Hide pagerduty attributes Show pagerduty attributes object
  
  account string
  
  attach_payload boolean Required
  
  client string
  
  client_url string
  
  contexts array[object]
  
  Additional properties are allowed.
  
  description string Required
  
  event_type string
  
  Values are trigger, resolve, or acknowledge.
  
  incident_key string Required
  
  proxy object
  
  Additional properties are allowed.
  
  Hide proxy attributes Show proxy attributes object
  
  host string
  
  port number
  
  slack object
  
  Additional properties are allowed.
  
  Hide slack attributes Show slack attributes object
  
  account string
  
  message object Required
  
  Additional properties are allowed.
  
  Hide message attributes Show message attributes object
  
  attachments array[object] Required
  
  Additional properties are allowed.
  
  dynamic_attachments object
  
  Additional properties are allowed.
  
  Hide dynamic_attachments attributes Show dynamic_attachments attributes object
  
  attachment_template object Required
  
  Additional properties are allowed.
  
  list_path string Required
  
  from string Required
  
  icon string
  
  text string Required
  
  to array[string] Required
  
  webhook object
  
  Additional properties are allowed.
  
  Hide webhook attributes Show webhook attributes object
  
  auth object
  
  Additional properties are allowed.
  
  Hide auth attribute Show auth attribute object
  
  basic object Required
  
  Additional properties are allowed.
  
  body string
  
  connection_timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  headers object
  
  Hide headers attribute Show headers attribute object
  
  * string Additional properties
  
  host string
  
  method string
  
  Values are head, get, post, put, or delete.
  
  params object
  
  Hide params attribute Show params attribute object
  
  * string Additional properties
  
  path string
  
  port number
  
  proxy object
  
  Additional properties are allowed.
  
  Hide proxy attributes Show proxy attributes object
  
  host string Required
  
  port number Required
  
  read_timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  scheme string
  
  Values are http or https.
  
  url string
- condition object Required
  
  Additional properties are allowed.
  Hide condition attributes Show condition attributes object
  
  always object
  
  Additional properties are allowed.
  
  array_compare object
  
  Hide array_compare attribute Show array_compare attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  Hide * attribute Show * attribute object
  
  path string Required
  
  compare object
  
  Hide compare attribute Show compare attribute object
  
  * object Additional properties
  
  never object
  
  Additional properties are allowed.
  
  script object
  
  Additional properties are allowed.
  
  Hide script attributes Show script attributes object
  
  lang string
  
  params object
  
  Hide params attribute Show params attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  source string
  
  id string
- input object Required
  
  Additional properties are allowed.
  Hide input attributes Show input attributes object
  
  chain object
  
  Additional properties are allowed.
  
  Hide chain attribute Show chain attribute object
  
  inputs array[object] Required
  
  Hide inputs attribute Show inputs attribute object
  
  * object
  
  Additional properties are allowed.
  
  http object
  
  Additional properties are allowed.
  
  Hide http attributes Show http attributes object
  
  extract array[string]
  
  request object
  
  Additional properties are allowed.
  
  Hide request attributes Show request attributes object
  
  auth object
  
  Additional properties are allowed.
  
  Hide auth attribute Show auth attribute object
  
  basic object Required
  
  Additional properties are allowed.
  
  Hide basic attributes Show basic attributes object
  
  password string Required
  
  username string Required
  
  body string
  
  connection_timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  headers object
  
  Hide headers attribute Show headers attribute object
  
  * string Additional properties
  
  host string
  
  method string
  
  Values are head, get, post, put, or delete.
  
  params object
  
  Hide params attribute Show params attribute object
  
  * string Additional properties
  
  path string
  
  port number
  
  proxy object
  
  Additional properties are allowed.
  
  Hide proxy attributes Show proxy attributes object
  
  host string Required
  
  port number Required
  
  read_timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  scheme string
  
  Values are http or https.
  
  url string
  
  response_content_type string
  
  Values are json, yaml, or text.
  
  search object
  
  Additional properties are allowed.
  
  Hide search attributes Show search attributes object
  
  extract array[string]
  
  request object Required
  
  Additional properties are allowed.
  
  Hide request attributes Show request attributes object
  
  body object
  
  Additional properties are allowed.
  
  Hide body attribute Show body attribute object
  
  query object Required
  
  Additional properties are allowed.
  
  External documentation
  
  indices array[string]
  
  indices_options object
  
  Additional properties are allowed.
  
  Hide indices_options attributes Show indices_options attributes object
  
  allow_no_indices boolean
  
  If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar.
  
  expand_wildcards string | array[string]
  
  ignore_unavailable boolean
  
  If true, missing or closed indices are not included in the response.
  
  ignore_throttled boolean
  
  If true, concrete, expanded or aliased indices are ignored when frozen.
  
  search_type string
  
  Values are query_then_fetch or dfs_query_then_fetch.
  
  template object
  
  Additional properties are allowed.
  
  Hide template attributes Show template attributes object
  
  explain boolean
  
  id string
  
  params object
  
  Hide params attribute Show params attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  profile boolean
  
  source string
  
  An inline search template. Supports the same parameters as the search API's request body. Also supports Mustache variables. If no id is specified, this parameter is required.
  
  rest_total_hits_as_int boolean
  
  timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  simple object
  
  Hide simple attribute Show simple attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
- metadata object
  Hide metadata attribute Show metadata attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
- status object
  
  Additional properties are allowed.
  Hide status attributes Show status attributes object
  
  actions object Required
  
  Hide actions attribute Show actions attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  Hide * attributes Show * attributes object
  
  ack object Required
  
  Additional properties are allowed.
  
  Hide ack attributes Show ack attributes object
  
  state string Required
  
  Values are awaits_successful_execution, ackable, or acked.
  
  timestamp string
  
  last_execution object
  
  Additional properties are allowed.
  
  Hide last_execution attributes Show last_execution attributes object
  
  successful boolean Required
  
  timestamp string
  
  reason string
  
  last_successful_execution object
  
  Additional properties are allowed.
  
  Hide last_successful_execution attributes Show last_successful_execution attributes object
  
  successful boolean Required
  
  timestamp string
  
  reason string
  
  last_throttle object
  
  Additional properties are allowed.
  
  Hide last_throttle attributes Show last_throttle attributes object
  
  reason string Required
  
  timestamp string
  
  last_checked string | number
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  last_met_condition string | number
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  state object Required
  
  Additional properties are allowed.
  
  Hide state attributes Show state attributes object
  
  active boolean Required
  
  timestamp string | number Required
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  version number Required
  
  execution_state string
- throttle_period string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
- throttle_period_in_millis number
  
  Time unit for milliseconds
- transform object
  
  Additional properties are allowed.
  Hide transform attributes Show transform attributes object
  
  chain array[object]
  
  Additional properties are allowed.
  
  script object
  
  Additional properties are allowed.
  
  Hide script attributes Show script attributes object
  
  lang string
  
  params object
  
  Hide params attribute Show params attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  source string
  
  id string
  
  search object
  
  Additional properties are allowed.
  
  Hide search attributes Show search attributes object
  
  request object Required
  
  Additional properties are allowed.
  
  Hide request attributes Show request attributes object
  
  body object
  
  Additional properties are allowed.
  
  Hide body attribute Show body attribute object
  
  query object Required
  
  Additional properties are allowed.
  
  External documentation
  
  indices array[string]
  
  indices_options object
  
  Additional properties are allowed.
  
  Hide indices_options attributes Show indices_options attributes object
  
  allow_no_indices boolean
  
  If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar.
  
  expand_wildcards string | array[string]
  
  ignore_unavailable boolean
  
  If true, missing or closed indices are not included in the response.
  
  ignore_throttled boolean
  
  If true, concrete, expanded or aliased indices are ignored when frozen.
  
  search_type string
  
  Values are query_then_fetch or dfs_query_then_fetch.
  
  template object
  
  Additional properties are allowed.
  
  Hide template attributes Show template attributes object
  
  explain boolean
  
  id string
  
  params object
  
  Hide params attribute Show params attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  profile boolean
  
  source string
  
  An inline search template. Supports the same parameters as the search API's request body. Also supports Mustache variables. If no id is specified, this parameter is required.
  
  rest_total_hits_as_int boolean
  
  timeout string Required
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
- trigger object Required
  
  Additional properties are allowed.
  Hide trigger attribute Show trigger attribute object
  
  schedule object
  
  Additional properties are allowed.
  
  Hide schedule attributes Show schedule attributes object
  
  cron string
  
  daily object
  
  Additional properties are allowed.
  
  Hide daily attribute Show daily attribute object
  
  at array[string | object] Required
  
  A time of day, expressed either as hh:mm, noon, midnight, or an hour/minutes structure.
  
  One of:
  _types:ScheduleTimeOfDay string _types:HourAndMinute object
  
  Additional properties are allowed.
  
  hourly object
  
  Additional properties are allowed.
  
  Hide hourly attribute Show hourly attribute object
  
  minute array[number] Required
  
  interval string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  monthly object | array[object]
  
  One of:
  _types:TimeOfMonth object array-2 array[object]
  
  Hide attributes Show attributes object
  
  at array[string] Required
  
  on array[number] Required
  
  weekly object | array[object]
  
  One of:
  _types:TimeOfWeek object array-2 array[object]
  
  Hide attributes Show attributes object
  
  at array[string] Required
  
  on array[string] Required
  
  Values are sunday, monday, tuesday, wednesday, thursday, friday, or saturday.
  
  yearly object | array[object]
  
  One of:
  _types:TimeOfYear object array-2 array[object]
  
  Hide attributes Show attributes
  
  at array[string] Required
  
  int array[string] Required
  
  Values are january, february, march, april, may, june, july, august, september, october, november, or december.
  
  on array[number] Required
  
  Hide attributes Show attributes object
  
  at array[string] Required
  
  int array[string] Required
  
  Values are january, february, march, april, may, june, july, august, september, october, november, or december.
  
  on array[number] Required

Responses

200 application/json
Hide response attributes Show response attributes object
- _id string Required
- watch_record object Required
  
  Additional properties are allowed.
  
  Hide watch_record attributes Show watch_record attributes object
  
  condition object Required
  
  Additional properties are allowed.
  
  Hide condition attributes Show condition attributes object
  
  always object
  
  Additional properties are allowed.
  
  array_compare object
  
  Hide array_compare attribute Show array_compare attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  Hide * attribute Show * attribute object
  
  path string Required
  
  compare object
  
  Hide compare attribute Show compare attribute object
  
  * object Additional properties
  
  never object
  
  Additional properties are allowed.
  
  script object
  
  Additional properties are allowed.
  
  Hide script attributes Show script attributes object
  
  lang string
  
  params object
  
  Hide params attribute Show params attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  source string
  
  id string
  
  input object Required
  
  Additional properties are allowed.
  
  Hide input attributes Show input attributes object
  
  chain object
  
  Additional properties are allowed.
  
  Hide chain attribute Show chain attribute object
  
  inputs array[object] Required
  
  Hide inputs attribute Show inputs attribute object
  
  * object
  
  Additional properties are allowed.
  
  http object
  
  Additional properties are allowed.
  
  Hide http attributes Show http attributes object
  
  extract array[string]
  
  request object
  
  Additional properties are allowed.
  
  Hide request attributes Show request attributes object
  
  auth object
  
  Additional properties are allowed.
  
  Hide auth attribute Show auth attribute object
  
  basic object Required
  
  Additional properties are allowed.
  
  body string
  
  connection_timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  headers object
  
  Hide headers attribute Show headers attribute object
  
  * string Additional properties
  
  host string
  
  method string
  
  Values are head, get, post, put, or delete.
  
  params object
  
  Hide params attribute Show params attribute object
  
  * string Additional properties
  
  path string
  
  port number
  
  proxy object
  
  Additional properties are allowed.
  
  Hide proxy attributes Show proxy attributes object
  
  host string Required
  
  port number Required
  
  read_timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  scheme string
  
  Values are http or https.
  
  url string
  
  response_content_type string
  
  Values are json, yaml, or text.
  
  search object
  
  Additional properties are allowed.
  
  Hide search attributes Show search attributes object
  
  extract array[string]
  
  request object Required
  
  Additional properties are allowed.
  
  Hide request attributes Show request attributes object
  
  body object
  
  Additional properties are allowed.
  
  Hide body attribute Show body attribute object
  
  query object Required
  
  Additional properties are allowed.
  
  indices array[string]
  
  indices_options object
  
  Additional properties are allowed.
  
  Hide indices_options attributes Show indices_options attributes object
  
  allow_no_indices boolean
  
  If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar.
  
  expand_wildcards string | array[string]
  
  ignore_unavailable boolean
  
  If true, missing or closed indices are not included in the response.
  
  ignore_throttled boolean
  
  If true, concrete, expanded or aliased indices are ignored when frozen.
  
  search_type string
  
  Values are query_then_fetch or dfs_query_then_fetch.
  
  template object
  
  Additional properties are allowed.
  
  Hide template attributes Show template attributes object
  
  explain boolean
  
  id string
  
  params object
  
  profile boolean
  
  source string
  
  An inline search template. Supports the same parameters as the search API's request body. Also supports Mustache variables. If no id is specified, this parameter is required.
  
  rest_total_hits_as_int boolean
  
  timeout string
  
  A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
  
  simple object
  
  Hide simple attribute Show simple attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  messages array[string] Required
  
  metadata object
  
  Hide metadata attribute Show metadata attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  node string Required
  
  result object Required
  
  Additional properties are allowed.
  
  Hide result attributes Show result attributes object
  
  actions array[object] Required
  
  Hide actions attributes Show actions attributes object
  
  email object
  
  Additional properties are allowed.
  
  Hide email attributes Show email attributes object
  
  account string
  
  message object Required
  
  Additional properties are allowed.
  
  reason string
  
  id string Required
  
  index object
  
  Additional properties are allowed.
  
  Hide index attribute Show index attribute object
  
  response object Required
  
  Additional properties are allowed.
  
  logging object
  
  Additional properties are allowed.
  
  Hide logging attribute Show logging attribute object
  
  logged_text string Required
  
  pagerduty object
  
  Additional properties are allowed.
  
  Hide pagerduty attributes Show pagerduty attributes object
  
  event object Required
  
  Additional properties are allowed.
  
  reason string
  
  request
  
  response object
  
  Additional properties are allowed.
  
  reason string
  
  slack object
  
  Additional properties are allowed.
  
  Hide slack attributes Show slack attributes object
  
  account string
  
  message object Required
  
  Additional properties are allowed.
  
  status string Required
  
  Values are success, failure, simulated, or throttled.
  
  type string Required
  
  Values are email, webhook, index, logging, slack, or pagerduty.
  
  webhook object
  
  Additional properties are allowed.
  
  Hide webhook attributes Show webhook attributes object
  
  request
  
  response object
  
  Additional properties are allowed.
  
  error object
  
  Additional properties are allowed.
  
  Hide error attributes Show error attributes object
  
  type string Required
  
  The type of error
  
  reason string
  
  A human-readable explanation of the error, in english
  
  stack_trace string
  
  The server stack trace. Present only if the error_trace=true parameter was sent with the request.
  
  caused_by object
  
  Additional properties are allowed.
  
  root_cause array[object]
  
  suppressed array[object]
  
  condition object Required
  
  Additional properties are allowed.
  
  Hide condition attributes Show condition attributes object
  
  met boolean Required
  
  status string Required
  
  Values are success, failure, simulated, or throttled.
  
  type string Required
  
  Values are always, never, script, compare, or array_compare.
  
  execution_duration number
  
  Time unit for milliseconds
  
  execution_time string | number Required
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  input object Required
  
  Additional properties are allowed.
  
  Hide input attributes Show input attributes object
  
  payload object Required
  
  Hide payload attribute Show payload attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  status string Required
  
  Values are success, failure, simulated, or throttled.
  
  type string Required
  
  Values are http, search, or simple.
  
  state string Required
  
  Values are awaits_execution, checking, execution_not_needed, throttled, executed, failed, deleted_while_queued, or not_executed_already_queued.
  
  trigger_event object Required
  
  Additional properties are allowed.
  
  Hide trigger_event attributes Show trigger_event attributes object
  
  manual object Required
  
  Additional properties are allowed.
  
  Hide manual attribute Show manual attribute object
  
  schedule object
  
  Additional properties are allowed.
  
  Hide schedule attributes Show schedule attributes object
  
  scheduled_time string
  
  triggered_time string
  
  triggered_time string | number Required
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  type string Required
  
  user string Required
  
  watch_id string Required
  
  status object
  
  Additional properties are allowed.
  
  Hide status attributes Show status attributes object
  
  actions object Required
  
  Hide actions attribute Show actions attribute object
  
  * object Additional properties
  
  Additional properties are allowed.
  
  Hide * attributes Show * attributes object
  
  ack object Required
  
  Additional properties are allowed.
  
  Hide ack attributes Show ack attributes object
  
  state string Required
  
  Values are awaits_successful_execution, ackable, or acked.
  
  timestamp
  
  last_execution object
  
  Additional properties are allowed.
  
  Hide last_execution attributes Show last_execution attributes object
  
  successful boolean Required
  
  timestamp
  
  reason string
  
  last_successful_execution object
  
  Additional properties are allowed.
  
  Hide last_successful_execution attributes Show last_successful_execution attributes object
  
  successful boolean Required
  
  timestamp
  
  reason string
  
  last_throttle object
  
  Additional properties are allowed.
  
  Hide last_throttle attributes Show last_throttle attributes object
  
  reason string Required
  
  timestamp
  
  last_checked string | number
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  last_met_condition string | number
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  state object Required
  
  Additional properties are allowed.
  
  Hide state attributes Show state attributes object
  
  active boolean Required
  
  timestamp string | number Required
  
  A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
  
  One of:
  _types:DateTime string _types:UnitMillis number
  
  Time unit for milliseconds
  
  version number Required
  
  execution_state string

POST /_watcher/watch/{id}/_execute

curl \
 -X POST http://api.example.com/_watcher/watch/{id}/_execute \
 -H "Content-Type: application/json" \
 -d '{"action_modes":{"additionalProperty1":"simulate","additionalProperty2":"simulate"},"alternative_input":{"additionalProperty1":{},"additionalProperty2":{}},"ignore_condition":true,"record_execution":true,"simulated_actions":{"actions":["string"],"all":{},"use_all":true},"trigger_data":{"":"string"},"watch":{"actions":{"additionalProperty1":{"action_type":"email","condition":{"always":{},"array_compare":{"additionalProperty1":{"path":"string"},"additionalProperty2":{"path":"string"}},"compare":{"additionalProperty1":{},"additionalProperty2":{}},"never":{},"script":{"lang":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"source":"string","id":"string"}},"foreach":"string","max_iterations":42.0,"name":"string","throttle_period":"string","":{"auth":{"basic":{}},"body":"string","connection_timeout":"string","headers":{"additionalProperty1":"string","additionalProperty2":"string"},"host":"string","method":"head","params":{"additionalProperty1":"string","additionalProperty2":"string"},"path":"string","port":42.0,"proxy":{"host":"string","port":42.0},"read_timeout":"string","scheme":"http","url":"string"},"transform":{"chain":[{}],"script":{"lang":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"source":"string","id":"string"},"search":{"request":{"body":{},"indices":["string"],"indices_options":{},"search_type":"query_then_fetch","template":{},"rest_total_hits_as_int":true},"timeout":"string"}},"index":{"index":"string","doc_id":"string","refresh":"true","op_type":"index","timeout":"string","execution_time_field":"string"},"logging":{"level":"string","text":"string","category":"string"},"slack":{"account":"string","message":{"attachments":[{}],"dynamic_attachments":{"attachment_template":{},"list_path":"string"},"from":"string","icon":"string","text":"string","to":["string"]}}},"additionalProperty2":{"action_type":"email","condition":{"always":{},"array_compare":{"additionalProperty1":{"path":"string"},"additionalProperty2":{"path":"string"}},"compare":{"additionalProperty1":{},"additionalProperty2":{}},"never":{},"script":{"lang":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"source":"string","id":"string"}},"foreach":"string","max_iterations":42.0,"name":"string","throttle_period":"string","":{"auth":{"basic":{}},"body":"string","connection_timeout":"string","headers":{"additionalProperty1":"string","additionalProperty2":"string"},"host":"string","method":"head","params":{"additionalProperty1":"string","additionalProperty2":"string"},"path":"string","port":42.0,"proxy":{"host":"string","port":42.0},"read_timeout":"string","scheme":"http","url":"string"},"transform":{"chain":[{}],"script":{"lang":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"source":"string","id":"string"},"search":{"request":{"body":{},"indices":["string"],"indices_options":{},"search_type":"query_then_fetch","template":{},"rest_total_hits_as_int":true},"timeout":"string"}},"index":{"index":"string","doc_id":"string","refresh":"true","op_type":"index","timeout":"string","execution_time_field":"string"},"logging":{"level":"string","text":"string","category":"string"},"slack":{"account":"string","message":{"attachments":[{}],"dynamic_attachments":{"attachment_template":{},"list_path":"string"},"from":"string","icon":"string","text":"string","to":["string"]}}}},"condition":{"always":{},"array_compare":{"additionalProperty1":{"path":"string"},"additionalProperty2":{"path":"string"}},"compare":{"additionalProperty1":{},"additionalProperty2":{}},"never":{},"script":{"lang":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"source":"string","id":"string"}},"input":{"chain":{"inputs":[{"*":{}}]},"http":{"extract":["string"],"request":{"auth":{"basic":{"password":"string","username":"string"}},"body":"string","connection_timeout":"string","headers":{"additionalProperty1":"string","additionalProperty2":"string"},"host":"string","method":"head","params":{"additionalProperty1":"string","additionalProperty2":"string"},"path":"string","port":42.0,"proxy":{"host":"string","port":42.0},"read_timeout":"string","scheme":"http","url":"string"},"response_content_type":"json"},"search":{"extract":["string"],"request":{"body":{"query":{}},"indices":["string"],"indices_options":{"allow_no_indices":true,"expand_wildcards":"string","ignore_unavailable":true,"ignore_throttled":true},"search_type":"query_then_fetch","template":{"explain":true,"id":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"profile":true,"source":"string"},"rest_total_hits_as_int":true},"timeout":"string"},"simple":{"additionalProperty1":{},"additionalProperty2":{}}},"metadata":{"additionalProperty1":{},"additionalProperty2":{}},"status":{"actions":{"additionalProperty1":{"ack":{"state":"awaits_successful_execution","":"string"},"last_execution":{"successful":true,"":"string","reason":"string"},"last_successful_execution":{"successful":true,"":"string","reason":"string"},"last_throttle":{"reason":"string","":"string"}},"additionalProperty2":{"ack":{"state":"awaits_successful_execution","":"string"},"last_execution":{"successful":true,"":"string","reason":"string"},"last_successful_execution":{"successful":true,"":"string","reason":"string"},"last_throttle":{"reason":"string","":"string"}}},"":"string","state":{"active":true,"":"string"},"version":42.0,"execution_state":"string"},"throttle_period":"string","":42.0,"transform":{"chain":[{}],"script":{"lang":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"source":"string","id":"string"},"search":{"request":{"body":{"query":{}},"indices":["string"],"indices_options":{"allow_no_indices":true,"expand_wildcards":"string","ignore_unavailable":true,"ignore_throttled":true},"search_type":"query_then_fetch","template":{"explain":true,"id":"string","params":{"additionalProperty1":{},"additionalProperty2":{}},"profile":true,"source":"string"},"rest_total_hits_as_int":true},"timeout":"string"}},"trigger":{"schedule":{"cron":"string","daily":{"at":["string"]},"hourly":{"minute":[42.0]},"interval":"string","monthly":{"at":["string"],"on":[42.0]},"weekly":{"at":["string"],"on":["sunday"]},"yearly":{"at":["string"],"int":["january"],"on":[42.0]}}}}}'

Request examples

{
  "action_modes": {
    "additionalProperty1": "simulate",
    "additionalProperty2": "simulate"
  },
  "alternative_input": {
    "additionalProperty1": {},
    "additionalProperty2": {}
  },
  "ignore_condition": true,
  "record_execution": true,
  "simulated_actions": {
    "actions": [
      "string"
    ],
    "all": {},
    "use_all": true
  },
  "trigger_data": {
    "": "string"
  },
  "watch": {
    "actions": {
      "additionalProperty1": {
        "action_type": "email",
        "condition": {
          "always": {},
          "array_compare": {
            "additionalProperty1": {
              "path": "string"
            },
            "additionalProperty2": {
              "path": "string"
            }
          },
          "compare": {
            "additionalProperty1": {},
            "additionalProperty2": {}
          },
          "never": {},
          "script": {
            "lang": "string",
            "params": {
              "additionalProperty1": {},
              "additionalProperty2": {}
            },
            "source": "string",
            "id": "string"
          }
        },
        "foreach": "string",
        "max_iterations": 42.0,
        "name": "string",
        "throttle_period": "string",
        "": {
          "auth": {
            "basic": {}
          },
          "body": "string",
          "connection_timeout": "string",
          "headers": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "host": "string",
          "method": "head",
          "params": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "path": "string",
          "port": 42.0,
          "proxy": {
            "host": "string",
            "port": 42.0
          },
          "read_timeout": "string",
          "scheme": "http",
          "url": "string"
        },
        "transform": {
          "chain": [
            {}
          ],
          "script": {
            "lang": "string",
            "params": {
              "additionalProperty1": {},
              "additionalProperty2": {}
            },
            "source": "string",
            "id": "string"
          },
          "search": {
            "request": {
              "body": {},
              "indices": [
                "string"
              ],
              "indices_options": {},
              "search_type": "query_then_fetch",
              "template": {},
              "rest_total_hits_as_int": true
            },
            "timeout": "string"
          }
        },
        "index": {
          "index": "string",
          "doc_id": "string",
          "refresh": "true",
          "op_type": "index",
          "timeout": "string",
          "execution_time_field": "string"
        },
        "logging": {
          "level": "string",
          "text": "string",
          "category": "string"
        },
        "slack": {
          "account": "string",
          "message": {
            "attachments": [
              {}
            ],
            "dynamic_attachments": {
              "attachment_template": {},
              "list_path": "string"
            },
            "from": "string",
            "icon": "string",
            "text": "string",
            "to": [
              "string"
            ]
          }
        }
      },
      "additionalProperty2": {
        "action_type": "email",
        "condition": {
          "always": {},
          "array_compare": {
            "additionalProperty1": {
              "path": "string"
            },
            "additionalProperty2": {
              "path": "string"
            }
          },
          "compare": {
            "additionalProperty1": {},
            "additionalProperty2": {}
          },
          "never": {},
          "script": {
            "lang": "string",
            "params": {
              "additionalProperty1": {},
              "additionalProperty2": {}
            },
            "source": "string",
            "id": "string"
          }
        },
        "foreach": "string",
        "max_iterations": 42.0,
        "name": "string",
        "throttle_period": "string",
        "": {
          "auth": {
            "basic": {}
          },
          "body": "string",
          "connection_timeout": "string",
          "headers": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "host": "string",
          "method": "head",
          "params": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "path": "string",
          "port": 42.0,
          "proxy": {
            "host": "string",
            "port": 42.0
          },
          "read_timeout": "string",
          "scheme": "http",
          "url": "string"
        },
        "transform": {
          "chain": [
            {}
          ],
          "script": {
            "lang": "string",
            "params": {
              "additionalProperty1": {},
              "additionalProperty2": {}
            },
            "source": "string",
            "id": "string"
          },
          "search": {
            "request": {
              "body": {},
              "indices": [
                "string"
              ],
              "indices_options": {},
              "search_type": "query_then_fetch",
              "template": {},
              "rest_total_hits_as_int": true
            },
            "timeout": "string"
          }
        },
        "index": {
          "index": "string",
          "doc_id": "string",
          "refresh": "true",
          "op_type": "index",
          "timeout": "string",
          "execution_time_field": "string"
        },
        "logging": {
          "level": "string",
          "text": "string",
          "category": "string"
        },
        "slack": {
          "account": "string",
          "message": {
            "attachments": [
              {}
            ],
            "dynamic_attachments": {
              "attachment_template": {},
              "list_path": "string"
            },
            "from": "string",
            "icon": "string",
            "text": "string",
            "to": [
              "string"
            ]
          }
        }
      }
    },
    "condition": {
      "always": {},
      "array_compare": {
        "additionalProperty1": {
          "path": "string"
        },
        "additionalProperty2": {
          "path": "string"
        }
      },
      "compare": {
        "additionalProperty1": {},
        "additionalProperty2": {}
      },
      "never": {},
      "script": {
        "lang": "string",
        "params": {
          "additionalProperty1": {},
          "additionalProperty2": {}
        },
        "source": "string",
        "id": "string"
      }
    },
    "input": {
      "chain": {
        "inputs": [
          {
            "*": {}
          }
        ]
      },
      "http": {
        "extract": [
          "string"
        ],
        "request": {
          "auth": {
            "basic": {
              "password": "string",
              "username": "string"
            }
          },
          "body": "string",
          "connection_timeout": "string",
          "headers": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "host": "string",
          "method": "head",
          "params": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "path": "string",
          "port": 42.0,
          "proxy": {
            "host": "string",
            "port": 42.0
          },
          "read_timeout": "string",
          "scheme": "http",
          "url": "string"
        },
        "response_content_type": "json"
      },
      "search": {
        "extract": [
          "string"
        ],
        "request": {
          "body": {
            "query": {}
          },
          "indices": [
            "string"
          ],
          "indices_options": {
            "allow_no_indices": true,
            "expand_wildcards": "string",
            "ignore_unavailable": true,
            "ignore_throttled": true
          },
          "search_type": "query_then_fetch",
          "template": {
            "explain": true,
            "id": "string",
            "params": {
              "additionalProperty1": {},
              "additionalProperty2": {}
            },
            "profile": true,
            "source": "string"
          },
          "rest_total_hits_as_int": true
        },
        "timeout": "string"
      },
      "simple": {
        "additionalProperty1": {},
        "additionalProperty2": {}
      }
    },
    "metadata": {
      "additionalProperty1": {},
      "additionalProperty2": {}
    },
    "status": {
      "actions": {
        "additionalProperty1": {
          "ack": {
            "state": "awaits_successful_execution",
            "": "string"
          },
          "last_execution": {
            "successful": true,
            "": "string",
            "reason": "string"
          },
          "last_successful_execution": {
            "successful": true,
            "": "string",
            "reason": "string"
          },
          "last_throttle": {
            "reason": "string",
            "": "string"
          }
        },
        "additionalProperty2": {
          "ack": {
            "state": "awaits_successful_execution",
            "": "string"
          },
          "last_execution": {
            "successful": true,
            "": "string",
            "reason": "string"
          },
          "last_successful_execution": {
            "successful": true,
            "": "string",
            "reason": "string"
          },
          "last_throttle": {
            "reason": "string",
            "": "string"
          }
        }
      },
      "": "string",
      "state": {
        "active": true,
        "": "string"
      },
      "version": 42.0,
      "execution_state": "string"
    },
    "throttle_period": "string",
    "": 42.0,
    "transform": {
      "chain": [
        {}
      ],
      "script": {
        "lang": "string",
        "params": {
          "additionalProperty1": {},
          "additionalProperty2": {}
        },
        "source": "string",
        "id": "string"
      },
      "search": {
        "request": {
          "body": {
            "query": {}
          },
          "indices": [
            "string"
          ],
          "indices_options": {
            "allow_no_indices": true,
            "expand_wildcards": "string",
            "ignore_unavailable": true,
            "ignore_throttled": true
          },
          "search_type": "query_then_fetch",
          "template": {
            "explain": true,
            "id": "string",
            "params": {
              "additionalProperty1": {},
              "additionalProperty2": {}
            },
            "profile": true,
            "source": "string"
          },
          "rest_total_hits_as_int": true
        },
        "timeout": "string"
      }
    },
    "trigger": {
      "schedule": {
        "cron": "string",
        "daily": {
          "at": [
            "string"
          ]
        },
        "hourly": {
          "minute": [
            42.0
          ]
        },
        "interval": "string",
        "monthly": {
          "at": [
            "string"
          ],
          "on": [
            42.0
          ]
        },
        "weekly": {
          "at": [
            "string"
          ],
          "on": [
            "sunday"
          ]
        },
        "yearly": {
          "at": [
            "string"
          ],
          "int": [
            "january"
          ],
          "on": [
            42.0
          ]
        }
      }
    }
  }
}

Response examples (200)

{
  "_id": "string",
  "watch_record": {
    "condition": {
      "always": {},
      "array_compare": {
        "additionalProperty1": {
          "path": "string"
        },
        "additionalProperty2": {
          "path": "string"
        }
      },
      "compare": {
        "additionalProperty1": {},
        "additionalProperty2": {}
      },
      "never": {},
      "script": {
        "lang": "string",
        "params": {
          "additionalProperty1": {},
          "additionalProperty2": {}
        },
        "source": "string",
        "id": "string"
      }
    },
    "input": {
      "chain": {
        "inputs": [
          {
            "*": {}
          }
        ]
      },
      "http": {
        "extract": [
          "string"
        ],
        "request": {
          "auth": {
            "basic": {}
          },
          "body": "string",
          "connection_timeout": "string",
          "headers": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "host": "string",
          "method": "head",
          "params": {
            "additionalProperty1": "string",
            "additionalProperty2": "string"
          },
          "path": "string",
          "port": 42.0,
          "proxy": {
            "host": "string",
            "port": 42.0
          },
          "read_timeout": "string",
          "scheme": "http",
          "url": "string"
        },
        "response_content_type": "json"
      },
      "search": {
        "extract": [
          "string"
        ],
        "request": {
          "body": {
            "query": {}
          },
          "indices": [
            "string"
          ],
          "indices_options": {
            "allow_no_indices": true,
            "expand_wildcards": "string",
            "ignore_unavailable": true,
            "ignore_throttled": true
          },
          "search_type": "query_then_fetch",
          "template": {
            "explain": true,
            "id": "string",
            "params": {},
            "profile": true,
            "source": "string"
          },
          "rest_total_hits_as_int": true
        },
        "timeout": "string"
      },
      "simple": {
        "additionalProperty1": {},
        "additionalProperty2": {}
      }
    },
    "messages": [
      "string"
    ],
    "metadata": {
      "additionalProperty1": {},
      "additionalProperty2": {}
    },
    "node": "string",
    "result": {
      "actions": [
        {
          "email": {
            "account": "string",
            "message": {},
            "reason": "string"
          },
          "id": "string",
          "index": {
            "response": {}
          },
          "logging": {
            "logged_text": "string"
          },
          "pagerduty": {
            "event": {},
            "reason": "string",
            "response": {}
          },
          "reason": "string",
          "slack": {
            "account": "string",
            "message": {}
          },
          "status": "success",
          "type": "email",
          "webhook": {
            "response": {}
          },
          "error": {
            "type": "string",
            "reason": "string",
            "stack_trace": "string",
            "caused_by": {},
            "root_cause": [
              {}
            ],
            "suppressed": [
              {}
            ]
          }
        }
      ],
      "condition": {
        "met": true,
        "status": "success",
        "type": "always"
      },
      "": "string",
      "input": {
        "payload": {
          "additionalProperty1": {},
          "additionalProperty2": {}
        },
        "status": "success",
        "type": "http"
      }
    },
    "state": "awaits_execution",
    "trigger_event": {
      "manual": {
        "schedule": {
          "": "string"
        }
      },
      "": "string",
      "type": "string"
    },
    "user": "string",
    "watch_id": "string",
    "status": {
      "actions": {
        "additionalProperty1": {
          "ack": {
            "state": "awaits_successful_execution"
          },
          "last_execution": {
            "successful": true,
            "reason": "string"
          },
          "last_successful_execution": {
            "successful": true,
            "reason": "string"
          },
          "last_throttle": {
            "reason": "string"
          }
        },
        "additionalProperty2": {
          "ack": {
            "state": "awaits_successful_execution"
          },
          "last_execution": {
            "successful": true,
            "reason": "string"
          },
          "last_successful_execution": {
            "successful": true,
            "reason": "string"
          },
          "last_throttle": {
            "reason": "string"
          }
        }
      },
      "": "string",
      "state": {
        "active": true,
        "": "string"
      },
      "version": 42.0,
      "execution_state": "string"
    }
  }
}

Run a watch

Path parameters

Query parameters

Body

scheduled_time string | number Required

triggered_time string | number

last_checked string | number

last_met_condition string | number

timestamp string | number Required

monthly object | array[object]

weekly object | array[object]

yearly object | array[object]

Responses

execution_time string | number Required

triggered_time string | number Required

last_checked string | number

last_met_condition string | number

timestamp string | number Required