<commit_before>[role="xpack"]
[[ml-open-job]]
=== Open Jobs

A job must be opened in order for it to be ready to receive and analyze data.
A job can be opened and closed multiple times throughout its lifecycle.


==== Request

`POST _xpack/ml/anomaly_detectors/{job_id}/_open`


==== Description

A job must be open in order to it to accept and analyze data.

When you open a new job, it starts with an empty model.

When you open an existing job, the most recent model state is automatically loaded.
The job is ready to resume its analysis from where it left off, once new data is received.


==== Path Parameters

`job_id` (required)::
(string) Identifier for the job


==== Request Body

`open_timeout`::
  (time) Controls the time to wait until a job has opened.
  The default value is 30 minutes.

`ignore_downtime`::
  (boolean) If true (default), any gap in data since it was
  last closed is treated as a maintenance window. That is to say, it is not an anomaly


==== Authorization

You must have `manage_ml`, or `manage` cluster privileges to use this API.
For more information, see
{xpack-ref}/security-privileges.html[Security Privileges].
//<<privileges-list-cluster>>.


==== Examples

The following example opens the `event_rate` job and sets an optional property:

[source,js]
--------------------------------------------------
POST _xpack/ml/anomaly_detectors/event_rate/_open
{
  "ignore_downtime": false
}
--------------------------------------------------
// CONSOLE
// TEST[skip:todo]

When the job opens, you receive the following results:
[source,js]
----
{
  "opened": true
}<commit_msg>[DOCS] Update ML open job API (elastic/x-pack-elasticsearch#1875)<commit_after>[role="xpack"]
[[ml-open-job]]
=== Open Jobs

A job must be opened in order for it to be ready to receive and analyze data.
A job can be opened and closed multiple times throughout its lifecycle.


==== Request

`POST _xpack/ml/anomaly_detectors/{job_id}/_open`


==== Description

A job must be open in order to it to accept and analyze data.

When you open a new job, it starts with an empty model.

When you open an existing job, the most recent model state is automatically loaded.
The job is ready to resume its analysis from where it left off, once new data is received.


==== Path Parameters

`job_id` (required)::
(string) Identifier for the job


==== Request Body

`timeout`::
  (time) Controls the time to wait until a job has opened.
  The default value is 30 minutes.


==== Authorization

You must have `manage_ml`, or `manage` cluster privileges to use this API.
For more information, see
{xpack-ref}/security-privileges.html[Security Privileges].
//<<privileges-list-cluster>>.


==== Examples

The following example opens the `event_rate` job and sets an optional property:

[source,js]
--------------------------------------------------
POST _xpack/ml/anomaly_detectors/event_rate/_open
{
  "timeout": "35m"
}
--------------------------------------------------
// CONSOLE
// TEST[skip:todo]

When the job opens, you receive the following results:
[source,js]
----
{
  "opened": true
}
{'fraction_non_alphanumeric': 0.1587455544778532, 'fraction_numerical': 0.0032331070158422245, 'mean_word_length': 3.055045871559633, 'pattern_counts': {'":': 4, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7232866', 'n_tokens_mistral': 911, 'n_tokens_neox': 865, 'n_words': 387}