# Predict future behavior of a time series

**POST /_ml/anomaly_detectors/{job_id}/_forecast**

Forecasts are not supported for jobs that perform population analysis; an
error occurs if you try to create a forecast for a job that has an
`over_field_name` in its configuration. Forcasts predict future behavior
based on historical data.

## Required authorization

* Cluster privileges: `manage_ml`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **job_id** (string)
  Identifier for the anomaly detection job. The job must be open when you
  create a forecast; otherwise, an error occurs.

### Query parameters
- **duration** (string)
  A period of time that indicates how far into the future to forecast. For
  example, `30d` corresponds to 30 days. The forecast starts at the last
  record that was processed.
- **expires_in** (string)
  The period of time that forecast results are retained. After a forecast
  expires, the results are deleted. If set to a value of 0, the forecast is
  never automatically deleted.
- **max_model_memory** (string)
  The maximum memory the forecast can use. If the forecast needs to use
  more than the provided amount, it will spool to disk. Default is 20mb,
  maximum is 500mb and minimum is 1mb. If set to 40% or more of the job’s
  configured memory limit, it is automatically reduced to below that
  amount.

### Body: application/json (object)

- **duration** (string)
  Refer to the description for the `duration` query parameter.
- **expires_in** (string)
  Refer to the description for the `expires_in` query parameter.
- **max_model_memory** (string)
  Refer to the description for the `max_model_memory` query parameter.


## Responses
### 200


#### Body: application/json (object)
- **acknowledged** (boolean)

- **forecast_id** (string)



[Powered by Bump.sh](https://bump.sh)