# Elastic ml anomaly API

**Canonical:** https://apis.io/apis/elastic/elastic-ml-anomaly-api/  
**Provider:** Elastic — https://apis.io/providers/elastic/  
**Base URL:** https://api.elastic-cloud.com  
**Documentation:** https://www.elastic.co/docs/api/doc/elasticsearch

Elastic ml anomaly API is one of 50 APIs that [Elastic](https://apis.io/providers/elastic/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include ml anomaly. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

The machine learning anomaly detection APIs enable you to perform anomaly detection activities.

## Operations (60 of 70)

| Method | Path | Summary |
|---|---|---|
| POST | `/_ml/anomaly_detectors/{job_id}/_close` | Close anomaly detection jobs |
| GET | `/_ml/calendars/{calendar_id}` | Get calendar configuration info |
| PUT | `/_ml/calendars/{calendar_id}` | Create a calendar |
| POST | `/_ml/calendars/{calendar_id}` | Get calendar configuration info |
| DELETE | `/_ml/calendars/{calendar_id}` | Delete a calendar |
| DELETE | `/_ml/calendars/{calendar_id}/events/{event_id}` | Delete events from a calendar |
| PUT | `/_ml/calendars/{calendar_id}/jobs/{job_id}` | Add anomaly detection job to calendar |
| DELETE | `/_ml/calendars/{calendar_id}/jobs/{job_id}` | Delete anomaly jobs from a calendar |
| GET | `/_ml/datafeeds/{datafeed_id}` | Get datafeeds configuration info |
| PUT | `/_ml/datafeeds/{datafeed_id}` | Create a datafeed |
| DELETE | `/_ml/datafeeds/{datafeed_id}` | Delete a datafeed |
| DELETE | `/_ml/_delete_expired_data/{job_id}` | Delete expired ML data |
| DELETE | `/_ml/_delete_expired_data` | Delete expired ML data |
| GET | `/_ml/filters/{filter_id}` | Get filters |
| PUT | `/_ml/filters/{filter_id}` | Create a filter |
| DELETE | `/_ml/filters/{filter_id}` | Delete a filter |
| POST | `/_ml/anomaly_detectors/{job_id}/_forecast` | Predict future behavior of a time series |
| DELETE | `/_ml/anomaly_detectors/{job_id}/_forecast` | Delete forecasts from a job |
| DELETE | `/_ml/anomaly_detectors/{job_id}/_forecast/{forecast_id}` | Delete forecasts from a job |
| GET | `/_ml/anomaly_detectors/{job_id}` | Get anomaly detection jobs configuration info |
| PUT | `/_ml/anomaly_detectors/{job_id}` | Create an anomaly detection job |
| DELETE | `/_ml/anomaly_detectors/{job_id}` | Delete an anomaly detection job |
| GET | `/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}` | Get model snapshots info |
| POST | `/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}` | Get model snapshots info |
| DELETE | `/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}` | Delete a model snapshot |
| POST | `/_ml/anomaly_detectors/_estimate_model_memory` | Estimate job model memory usage |
| POST | `/_ml/anomaly_detectors/{job_id}/_flush` | Force buffered data to be processed |
| GET | `/_ml/anomaly_detectors/{job_id}/results/buckets/{timestamp}` | Get anomaly detection job results for buckets |
| POST | `/_ml/anomaly_detectors/{job_id}/results/buckets/{timestamp}` | Get anomaly detection job results for buckets |
| GET | `/_ml/anomaly_detectors/{job_id}/results/buckets` | Get anomaly detection job results for buckets |
| POST | `/_ml/anomaly_detectors/{job_id}/results/buckets` | Get anomaly detection job results for buckets |
| GET | `/_ml/calendars/{calendar_id}/events` | Get info about events in calendars |
| POST | `/_ml/calendars/{calendar_id}/events` | Add scheduled events to the calendar |
| GET | `/_ml/calendars` | Get calendar configuration info |
| POST | `/_ml/calendars` | Get calendar configuration info |
| GET | `/_ml/anomaly_detectors/{job_id}/results/categories/{category_id}` | Get anomaly detection job results for categories |
| POST | `/_ml/anomaly_detectors/{job_id}/results/categories/{category_id}` | Get anomaly detection job results for categories |
| GET | `/_ml/anomaly_detectors/{job_id}/results/categories` | Get anomaly detection job results for categories |
| POST | `/_ml/anomaly_detectors/{job_id}/results/categories` | Get anomaly detection job results for categories |
| GET | `/_ml/datafeeds/{datafeed_id}/_stats` | Get datafeed stats |
| GET | `/_ml/datafeeds/_stats` | Get datafeed stats |
| GET | `/_ml/datafeeds` | Get datafeeds configuration info |
| GET | `/_ml/filters` | Get filters |
| GET | `/_ml/anomaly_detectors/{job_id}/results/influencers` | Get anomaly detection job results for influencers |
| POST | `/_ml/anomaly_detectors/{job_id}/results/influencers` | Get anomaly detection job results for influencers |
| GET | `/_ml/anomaly_detectors/_stats` | Get anomaly detection job stats |
| GET | `/_ml/anomaly_detectors/{job_id}/_stats` | Get anomaly detection job stats |
| GET | `/_ml/anomaly_detectors` | Get anomaly detection jobs configuration info |
| GET | `/_ml/anomaly_detectors/{job_id}/model_snapshots/{snapshot_id}/_upgrade/_stats` | Get anomaly detection job model snapshot upgrade usage info |
| GET | `/_ml/anomaly_detectors/{job_id}/model_snapshots` | Get model snapshots info |
| POST | `/_ml/anomaly_detectors/{job_id}/model_snapshots` | Get model snapshots info |
| GET | `/_ml/anomaly_detectors/{job_id}/results/overall_buckets` | Get overall bucket results |
| POST | `/_ml/anomaly_detectors/{job_id}/results/overall_buckets` | Get overall bucket results |
| GET | `/_ml/anomaly_detectors/{job_id}/results/records` | Get anomaly records for an anomaly detection job |
| POST | `/_ml/anomaly_detectors/{job_id}/results/records` | Get anomaly records for an anomaly detection job |
| POST | `/_ml/anomaly_detectors/{job_id}/_open` | Open anomaly detection jobs |
| POST | `/_ml/anomaly_detectors/{job_id}/_data` | Send data to an anomaly detection job for analysis |
| GET | `/_ml/datafeeds/{datafeed_id}/_preview` | Preview a datafeed |
| POST | `/_ml/datafeeds/{datafeed_id}/_preview` | Preview a datafeed |
| GET | `/_ml/datafeeds/_preview` | Preview a datafeed |

…and 10 more operations. They are listed in full on the page.

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/elastic/refs/heads/main/openapi/elastic-ml-anomaly-api-openapi.yml
- **Documentation** — https://www.elastic.co/docs/api/doc/elasticsearch
- **Documentation** — https://www.elastic.co/docs/api/doc/kibana
- **Documentation** — https://www.elastic.co/docs/api/doc/cloud
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/elastic/refs/heads/main/json-schema/elastic-saved-object-schema.json

## Other Elastic APIs (12)

- [Elastic Account API](https://apis.io/apis/elastic/elastic-account-api/)
- [Elastic Cluster API](https://apis.io/apis/elastic/elastic-cluster-api/)
- [Elastic Deployments API](https://apis.io/apis/elastic/elastic-deployments-api/)
- [Elastic Documents API](https://apis.io/apis/elastic/elastic-documents-api/)
- [Elastic Indices API](https://apis.io/apis/elastic/elastic-indices-api/)
- [Elastic Search API](https://apis.io/apis/elastic/elastic-search-api/)
- [Elastic Security API](https://apis.io/apis/elastic/elastic-security-api/)
- [Elastic Spaces API](https://apis.io/apis/elastic/elastic-spaces-api/)
- [Elastic Status API](https://apis.io/apis/elastic/elastic-status-api/)
- [Elastic TrafficFilters API](https://apis.io/apis/elastic/elastic-trafficfilters-api/)
- [Elastic Analytics API](https://apis.io/apis/elastic/elastic-analytics-api/)
- [Elastic Cat API](https://apis.io/apis/elastic/elastic-cat-api/)

## Tags

ml anomaly

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/elastic/elastic-ml-anomaly-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/elastic/.