[role="xpack"] [[ml-delete-calendar-event]] === Delete Events from Calendar API ++++ Delete Events from Calendar ++++ Deletes scheduled events from a calendar. ==== Request `DELETE _xpack/ml/calendars//events/` ==== Description This API removes individual events from a calendar. To remove all scheduled events and delete the calendar, see the <>. ==== Path Parameters `calendar_id`(required):: (string) Identifier for the calendar. `event_id` (required):: (string) Identifier for the scheduled event. You can obtain this identifier by using the <>. ==== 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]. ==== Examples The following example deletes a scheduled event from the `planned-outages` calendar: [source,js] -------------------------------------------------- DELETE _xpack/ml/calendars/planned-outages/events/LS8LJGEBMTCMA-qz49st -------------------------------------------------- // CONSOLE // TEST[catch:missing] When the event is removed, you receive the following results: [source,js] ---- { "acknowledged": true } ---- // NOTCONSOLE