[role="xpack"] [testenv="platinum"] [[start-dfanalytics]] === Start {dfanalytics-jobs} API [subs="attributes"] ++++ Start {dfanalytics-jobs} ++++ Starts a {dfanalytics-job}. experimental[] [[ml-start-dfanalytics-request]] ==== {api-request-title} `POST _ml/data_frame/analytics//_start` [[ml-start-dfanalytics-prereq]] ==== {api-prereq-title} * You must have `machine_learning_admin` built-in role to use this API. You must also have `read` and `view_index_metadata` privileges on the source index and `read`, `create_index`, and `index` privileges on the destination index. For more information, see <> and <>. [[ml-start-dfanalytics-path-params]] ==== {api-path-parms-title} ``:: (Required, string) include::{docdir}/ml/ml-shared.asciidoc[tag=job-id-data-frame-analytics-define] [[ml-start-dfanalytics-query-params]] ==== {api-query-parms-title} `timeout`:: (Optional, <>) include::{docdir}/ml/ml-shared.asciidoc[tag=timeout-start] [[ml-start-dfanalytics-example]] ==== {api-examples-title} The following example starts the `loganalytics` {dfanalytics-job}: [source,console] -------------------------------------------------- POST _ml/data_frame/analytics/loganalytics/_start -------------------------------------------------- // TEST[skip:setup:logdata_job] When the {dfanalytics-job} starts, you receive the following results: [source,console-result] ---- { "acknowledged" : true } ----