[role="xpack"] [testenv="platinum"] [[ml-delete-calendar-event]] === Delete events from calendar API ++++ Delete events from calendar ++++ Deletes scheduled events from a calendar. [[ml-delete-calendar-event-request]] ==== {api-request-title} `DELETE _ml/calendars//events/` [[ml-delete-calendar-event-prereqs]] ==== {api-prereq-title} * If the {es} {security-features} are enabled, you must have `manage_ml` or `manage` cluster privileges to use this API. See {stack-ov}/security-privileges.html[Security privileges]. [[ml-delete-calendar-event-desc]] ==== {api-description-title} This API removes individual events from a calendar. To remove all scheduled events and delete the calendar, see the <>. [[ml-delete-calendar-event-path-parms]] ==== {api-path-parms-title} ``:: (Required, string) Identifier for the calendar. ``:: (Required, string) Identifier for the scheduled event. You can obtain this identifier by using the <>. [[ml-delete-calendar-event-example]] ==== {api-examples-title} The following example deletes a scheduled event from the `planned-outages` calendar: [source,console] -------------------------------------------------- DELETE _ml/calendars/planned-outages/events/LS8LJGEBMTCMA-qz49st -------------------------------------------------- // TEST[skip:catch:missing] When the event is removed, you receive the following results: [source,js] ---- { "acknowledged": true } ----